Quick Start

대시보드 서버에 Web을 띄우고 업타임 모니터를 하나 추가해 첫 검사 결과를 확인합니다. 2단계에서 모니터가 정상으로 표시되면 기본 구성은 끝입니다. 그다음 필요한 기능을 직접 연결하고, Linux Docker 서버라면 Docker 환경도 연결할 수 있습니다. 두 단계 모두 선택입니다.

준비물

대시보드 서버: Docker와 Docker Compose
네트워크: 대시보드 서버에서 확인할 URL이나 TCP 포트에 접속할 수 있어야 합니다.

1. Web 실행 (대시보드 서버)

대시보드 서버에서 Compose 파일을 받습니다.

bash

mkdir everyup && cd everyup
curl -O \
https://raw.githubusercontent.com/ai-turn/everyup/main/web/docker-compose.yml

외부 접속 주소 정하기 (선택)

사용자나 모니터링할 서버가 다른 주소(예: https://monitor.example.com)로 Web에 접속한다면, 실행하기 전에 같은 디렉터리의 .env에 지정하세요.

bash

echo 'EVERYUP_PUBLIC_URL=https://monitor.example.com' > .env

EveryUp은 이 주소를 Docker 설치 명령, 직접 OTLP 연결, 인프라 Collector 설정에 넣습니다. 그래서 모니터링할 서버에서 접근할 수 있는 절대 HTTP(S) 주소여야 하며, localhost는 쓸 수 없습니다. 지정하지 않으면 연결 화면이 브라우저가 접속한 주소를 제안하고, 그 화면에서 고칠 수도 있습니다.

실행

bash

docker compose up -d

받은 Compose 파일의 내용

web/docker-compose.yml은 다음과 같습니다.

yaml

services:
  everyup:
    image: aiturn/everyup:latest
    container_name: everyup
    environment:
      EVERYUP_PUBLIC_URL: ${EVERYUP_PUBLIC_URL:-}
    ports:
      - "3001:3001"
    volumes:
      - everyup-data:/app/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:3001/api/v1/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 10s

volumes:
  everyup-data:
    driver: local

브라우저에서 http://<대시보드 서버 IP>:3001을 열고 첫 관리자 계정을 만듭니다. 열리지 않으면 대시보드가 열리지 않습니다를 확인하세요.

2. 업타임 모니터 추가 (브라우저)

업타임 화면에서 추가를 누르세요. 체크 방식은 HTTP로 두고, 이름과 확인할 공개 URL (예: https://api.example.com/health)을 입력한 뒤 추가를 누릅니다. 나머지 값은 기본값으로 두어도 됩니다.

검사는 Web이 수행하므로 대상에 아무것도 설치하지 않아도 됩니다. 첫 검사는 추가하자마자 실행되고, 이후 30초마다 반복됩니다. 응답 코드가 2xx이면 모니터가 정상으로 표시됩니다.

localhost나 사설망 같은 내부 주소는 확인할 수 없습니다. 입력 항목과 TCP 검사는 업타임 모니터를 참고하세요.

3. 기능별 직접 연결 (선택)

앱의 로그·API 요청·메트릭은 OpenTelemetry로 Web에 직접 보내고, 서버 자원은 표준 OpenTelemetry Collector로 보냅니다. Docker를 쓰지 않아도 연결할 수 있고, 필요한 기능만 골라 연결하면 됩니다.

데이터	대시보드에서 여는 경로
로그	로그 → 로그 연결 → OpenTelemetry로 직접 연결
API 요청·트레이스	API 요청 → API 연결 → OpenTelemetry로 직접 연결
앱 메트릭	메트릭 → 메트릭 연결 → OpenTelemetry로 직접 연결
서버 자원	인프라 → 인프라 연결

연결 화면에서 데이터 전송 주소와 API Key를 확인한 뒤 앱이나 Collector에 적용하세요. 언어별 설정과 수신 확인 방법은 OpenTelemetry로 직접 연결에 있습니다.

4. Docker 환경 연결 (선택)

Linux Docker 서버에 모니터링 번들(Docker Collector와 필요한 구성 요소)을 설치하면, 앱을 고치지 않고 컨테이너 상태·로그·호스트 자원·API 요청을 한 번에 수집합니다. 이 데이터는 업타임·로그·인프라 같은 기능 메뉴가 아니라 해당 Docker 환경 화면에 표시됩니다. 서버가 한 대라면 Web과 같은 서버에 설치해도 됩니다.

모니터링할 서버에는 다음이 필요합니다.

Linux, Docker Engine, Docker Compose 2.23.1 이상, curl, sudo 권한. Compose 버전은 docker compose version으로 확인하세요.
대시보드 서버의 3001 포트(또는 EVERYUP_PUBLIC_URL로 지정한 주소)에 접속할 수 있는 네트워크

Docker 연결 명령 만들기 (브라우저)

브라우저에서 대시보드의 Docker 환경 화면을 여세요. 오른쪽 위의 Docker 연결을 누른 뒤 환경 이름과 수집 범위를 정하세요.

수집 범위	수집·수신 기능	설치되는 구성 요소
전체	컨테이너 상태·로그·인프라·API 요청 수집, OTLP 메트릭 수신	Docker Collector, eBPF Observer
기본	Docker 서비스 상태, 로그	Docker Collector
사용자 지정	고른 기능만 (권한도 그만큼만)	Docker Collector. API 요청을 고르면 eBPF Observer도

앱 메트릭은 수신 기능을 켠 뒤 앱이나 OpenTelemetry Collector에서 전송하도록 설정해야 합니다. 로그나 API 요청을 선택하면 Docker 탐색에 필요한 업타임 수집도 함께 켜집니다.

eBPF Observer는 앱을 고치지 않고 API 요청의 latency와 트레이스를 수집하는 구성 요소입니다. Docker Collector와 권한이 분리되어 실행되고, 컨테이너 프로세스를 자동으로 찾으므로 포트 목록을 관리할 필요가 없습니다.

사용자 지정 프로필에서 업타임을 빼는 경우

Docker 상태 수집(업타임)을 선택하지 않은 프로필(예: 메트릭 전용)에서 앱 데이터를 Collector의 OTLP 게이트웨이(:4318)로 보낸다면 서비스별 bearer 토큰이 필요합니다. 앱마다 토큰을 발급해 Authorization 헤더에 설정하세요. 발급 명령과 설정 예시는 Collector 네트워킹 안내에 있습니다.

선택을 마치면 설치 명령이 표시됩니다. 명령은 다음과 같은 형태입니다.

bash

curl -fsSL 'https://<Web 주소>/api/v1/agents/install.sh' |
  sudo sh -s -- 'https://<Web 주소>' '<연결 코드>'

연결 코드는 10분 동안 한 번만 쓸 수 있습니다

코드가 만료되었거나 이미 사용했다면 설치 화면에서 새 코드를 눌러 다시 발급하세요. 장기 API Key는 브라우저에 표시되지 않고, 설치 과정에서 대상 서버로 직접 전달됩니다.

모니터링 번들 설치 (모니터링할 서버)

화면에 표시된 명령을 복사해 모니터링할 Linux Docker 서버에서 실행합니다.

설치기는 Docker와 Compose 버전을 확인한 뒤 /opt/everyup-agent에 설정을 만들고, 선택한 수집 범위에 필요한 구성 요소만 시작합니다. 기존 설정이 있으면 compose.yaml.bak.<날짜시각>으로 백업한 뒤 덮어씁니다. 앱의 Compose 파일, 이미지, 포트, 컨테이너는 바꾸지 않습니다. 경로와 컨테이너 이름에 들어가는 everyup-agent는 Docker Collector의 내부 이름입니다.

설치가 끝나면 마지막에 다음과 같이 출력됩니다.

text

EveryUp Docker collector installation complete.
Configuration: /opt/everyup-agent/compose.yaml
Check status: docker compose --env-file /opt/everyup-agent/.env -f /opt/everyup-agent/compose.yaml ps

중간에 멈췄다면 마지막 오류 줄로 트러블슈팅에서 해당 항목을 찾으세요.

설치기 없이 직접 구성하려면 agent/docker-compose.yml과 Docker Collector 설정을 참고하세요.

연결 확인 (브라우저)

설치가 끝나면 브라우저에서 Docker 환경 화면을 확인하세요. 약 30초 안에 해당 환경이 설치 대기에서 수집 중으로 바뀝니다. 업타임 수집을 선택했다면 그 서버의 컨테이너도 서비스로 나타납니다.

Docker 환경 목록. prod-server는 수집 중, staging-api는 설치 대기 상태다.

수집 중이면 연결된 것이고, 설치 대기면 아직 Collector가 연결되지 않은 것입니다.

시간이 지나도 설치 대기에 머문다면 트러블슈팅을 확인하세요.

수집 중은 Collector 연결 상태입니다. 해당 환경을 열고 모니터링 설정 가이드에서 설정 적용 여부와 데이터 수신 확인도 보세요. 앱에 요청을 보내 로그·트레이스를 발생시키고, 앱 메트릭은 전송 설정을 적용한 뒤 수집 주기가 지났을 때 수신 기록을 확인하세요.

다음 단계

모니터링 대상을 연결했다면 알림을 설정하세요. Telegram·Discord·Slack 채널을 연결하고 알림 규칙을 활성화하면 규칙의 조건을 만족할 때 알림을 받습니다.

그 밖의 가이드:

업타임 모니터: URL·TCP 포트 확인, 일시정지와 체크 기록
모니터링 설정: OpenTelemetry 직접 연결, 수집 상태 진단, Docker 환경에 기능 추가
헤더·바디 상세 수집: 요청이 실패한 이유까지 진단
자동 eBPF Observer: Docker 환경에서 API latency와 트레이스 수집
업그레이드·제거: 새 버전 적용, 설치 되돌리기

Quick Start ​

준비물 ​

1. Web 실행 (대시보드 서버) ​

외부 접속 주소 정하기 (선택) ​

실행 ​

2. 업타임 모니터 추가 (브라우저) ​

3. 기능별 직접 연결 (선택) ​

4. Docker 환경 연결 (선택) ​

Docker 연결 명령 만들기 (브라우저) ​

모니터링 번들 설치 (모니터링할 서버) ​

연결 확인 (브라우저) ​

다음 단계 ​

Quick Start

준비물

1. Web 실행 (대시보드 서버)

외부 접속 주소 정하기 (선택)

실행

2. 업타임 모니터 추가 (브라우저)

3. 기능별 직접 연결 (선택)

4. Docker 환경 연결 (선택)

Docker 연결 명령 만들기 (브라우저)

모니터링 번들 설치 (모니터링할 서버)

연결 확인 (브라우저)

다음 단계