메인 콘텐츠로 건너뛰기

Prometheus

메트릭 수집을 위한 FASTPANEL과 Prometheus의 통합

경고

이 기능은 Extended License 사용자가 독점적으로 이용할 수 있습니다.

FASTPANEL®은 이제 시스템 메트릭 수집을 위해 Prometheus 통합을 지원합니다. 이 가이드는 FASTPANEL® 인스턴스를 Prometheus에 추가하는 데 필요한 단계를 안내하며, 이를 통해 시스템 메트릭을 실시간으로 수집하고 모니터링할 수 있습니다.

토큰 생성

Prometheus가 메트릭을 수집할 수 있도록 하려면 제한된 접근 권한이 있는 특수 토큰을 생성해야 합니다:

  1. SSH를 통해 FASTPANEL® 서버에 연결합니다.

  2. 토큰을 생성하려면 다음 명령을 실행합니다:

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의 사용자 지정 이름
  • targetsFASTPANEL® 서버의 IP 주소와 포트입니다. $IP를 서버의 IP 주소로 바꾸십시오
  • metrics_path — 메트릭을 가져올 API 엔드포인트
  • bearer_token — 생성한 토큰(metrics_test_token)으로 바꾸십시오
  • scrape_interval — Prometheus가 메트릭을 수집하는 빈도(이 경우 60초로 설정)

모니터링 대시보드 구성

FASTPANEL® 인스턴스를 Prometheus에 성공적으로 추가한 후에는 수집된 메트릭을 시각화하기 위한 첫 번째 대시보드를 설정할 수 있습니다.

다음 링크를 사용하여 FASTPANEL® 메트릭 전용으로 미리 만들어진 Grafana 대시보드를 받을 수 있습니다:
FASTPANEL Dashboard

대시보드를 가져오려면 이 가이드를 따르십시오.

이제 Prometheus가 FASTPANEL® 인스턴스에서 메트릭 수집을 시작하여 시스템 성능을 실시간으로 모니터링할 수 있게 됩니다.