시작하기

시작하기 (First steps)

Prometheus를 처음 설치하고, 대상을 스크레이프하고, 쿼리하고, 알림 규칙을 만드는 과정을 차근차근 안내하는 문서예요. Prometheus 바이너리를 받아 실행하고, 기본 설정으로 자신의 메트릭을 수집한 뒤, 홈페이지와 그래프로 확인하는 흐름으로 진행됩니다.

모니터링 도구의 "Hello World"라고 할 수 있는 이 튜토리얼을 따라 하면, Prometheus가 어떻게 동작하는지 전체 흐름을 손쉽게 경험할 수 있어요. (이 페이지의 내용은 버전에 따라 다소 다를 수 있습니다.)

출처: 문서

아래는 일반적인 Prometheus 시작 단계 요약입니다. 최신 정확한 명령·URL은 공식 문서를 함께 확인하세요.

다운로드 페이지에서 운영체제에 맞는 최신 릴리즈를 받아 압축을 풉니다:

tar xzf prometheus-*.tar.gz
cd prometheus-*

기본 설정 파일은 Prometheus 자신의 메트릭을 스크레이프하는 예제를 포함합니다:

global:
  scrape_interval: 15s

scrape_configs:
  - job_name: prometheus
    static_configs:
      - targets: ['localhost:9090']

./prometheus --config.file=prometheus.yml

http://localhost:9090에서 Prometheus UI에 접속할 수 있습니다.

http://localhost:9090/metrics에서 Prometheus가 노출하는 메트릭(Go 런타임, 프로세스, HTTP 등)을 확인할 수 있습니다.

Graph 탭에서 간단한 쿼리를 실행합니다. 예:

promhttp_metric_handler_requests_total

또는 up 쿼리로 현재 스크레이프 중인 대상의 상태(1)를 확인합니다.

Status > Targets 페이지에서 스크레이프 중인 대상과 그 상태(UP/DOWN)를 볼 수 있습니다.