Prometheus
메트릭 수집을 위한 FASTPANEL과 Prometheus의 통합
경고
이 기능은 Extended License 사용자가 독점적으로 이용할 수 있습니다.
FASTPANEL®은 이제 시스템 메트릭 수집을 위해 Prometheus 통합을 지원합니다. 이 가이드는 FASTPANEL® 인스턴스를 Prometheus에 추가하는 데 필요한 단계를 안내하며, 이를 통해 시스템 메트릭을 실시간으로 수집하고 모니터링할 수 있습니다.
토큰 생성
Prometheus가 메트릭을 수집할 수 있도록 하려면 제한된 접근 권한이 있는 특수 토큰을 생성해야 합니다:
-
SSH를 통해 FASTPANEL® 서버에 연결합니다.
-
토큰을 생성하려면 다음 명령을 실행합니다:
mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only
- metrics_test_token은 토큰의 사용자 지정 이름이며, 원하는 이름을 선택할 수 있습니다
- 토큰에는 다음 범위가 부여됩니다:
- read_only — 읽기 전용 접근 권한
- metrics_only — 메트릭으로 제한된 접근 권한
Prometheus에 job 추가
토큰이 생성되면, FASTPANEL® 인스턴스에서 메트릭 수집을 시작하도록 Prometheus를 구성해야 합니다.
Prometheus 구성 파일을 열고 새 job을 추가합니다:
- job_name: "fastpanel2"
scheme: https
static_configs:
- targets: ["$IP:8888"]
metrics_path: /api/metrics
tls_config:
insecure_skip_verify: true
bearer_token: I_AM_TOKEN
scrape_interval: 60s
- job_name — job의 사용자 지정 이름
- targets — FASTPANEL® 서버의 IP 주소와 포트입니다.
$IP를 서버의 IP 주소로 바꾸십시오 - metrics_path — 메트릭을 가져올 API 엔드포인트
- bearer_token — 생성한 토큰(metrics_test_token)으로 바꾸십시오
- scrape_interval — Prometheus가 메트릭을 수집하는 빈도(이 경우 60초로 설정)
모니터링 대시보드 구성
FASTPANEL® 인스턴스를 Prometheus에 성공적으로 추가한 후에는 수집된 메트릭을 시각화하기 위한 첫 번째 대시보드를 설정할 수 있습니다.
다음 링크를 사용하여 FASTPANEL® 메트릭 전용으로 미리 만들어진 Grafana 대시보드를 받을 수 있습니다:
FASTPANEL Dashboard
대시보드를 가져오려면 이 가이드를 따르십시오.
이제 Prometheus가 FASTPANEL® 인스턴스에서 메트릭 수집을 시작하여 시스템 성능을 실시간으로 모니터링할 수 있게 됩니다.