콘텐츠로 이동
mofcloud

모니터링

마지막 업데이트:

MOF는 Prometheus 메트릭을 제공합니다: 프로세스, 청구서와 리소스 동기화 여부, 백그라운드 작업, 라이선스, HTTP 및 MCP 트래픽. 옆에 Prometheus와 Grafana를 추가하거나 기존 인스턴스가 MOF를 수집하도록 설정하세요.

요구 사항
MOF v2.0.14+
메트릭 엔드포인트
http://mof:8080/internal/v1/mof/metrics
노출 범위
내부 전용: Dash는 이 경로를 전달하지 않습니다.

Docker Compose

MOF 옆에 Prometheus와 Grafana를 추가합니다. Prometheus에는 MOF 알림 규칙이, Grafana에는 Prometheus 데이터 소스가 미리 설정되어 있습니다.

다운로드

두 파일 모두 compose.yaml 옆에 둡니다.

시작

Terminal
docker compose -f compose.yaml -f compose.monitoring.yaml up -d

대시보드 가져오기

  1. 브라우저에서 http://SERVER_IP:3000에 접속해 admin / admin으로 로그인하고 새 비밀번호를 설정합니다.
  2. Dashboards → New → Import → Upload dashboard JSON file에서 mof-grafana-dashboard.json을 선택합니다.
  • 3000번 포트는 자체 네트워크에서만 접근을 허용하세요.
  • 메모리를 약 300MB 더 사용하며, Prometheus는 15일치 데이터를 보관합니다. 이미지: prom/prometheus:v2.53.1, grafana/grafana:11.1.0; Docker Compose v2.23 이상.
  • 이후 명령(pull, up -d)에도 두 파일을 모두 지정하세요. 그렇지 않으면 모니터링 서비스가 빠집니다.

기존 Prometheus와 Grafana

파일용도
prometheus.yml ↓MOF 스크레이프 작업. Prometheus가 사설 네트워크를 통해 MOF의 8080 포트에 접근할 수 있어야 합니다.
mof-alerts.yml ↓알림 규칙. rule_files 아래에 추가합니다.
mof-grafana-dashboard.json ↓Grafana에서 가져온 뒤 Prometheus 데이터 소스를 선택합니다.

web 프로세스가 여러 개이면 각 프로세스가 배포 전체의 값(프로세스, 동기화, 작업)을 보고합니다. 대시보드와 규칙은 max()를 사용하므로 모두 수집해도 괜찮습니다. Worker는 HTTP를 제공하지 않으며, 그 작업은 web 프로세스를 통해 드러납니다.

Kubernetes

MOF Pod에는 일반적인 prometheus.io 어노테이션(scrape, 포트 8080, path)이 붙어 있어, 어노테이션으로 Pod를 찾는 Prometheus라면 자동으로 수집합니다. Prometheus Operator를 사용한다면 PodMonitor를 추가하세요:

podmonitor.yaml
apiVersion: monitoring.coreos.com/v1
kind: PodMonitor
metadata:
  name: mof
  namespace: mof
spec:
  selector:
    matchLabels:
      app: mof
  podMetricsEndpoints:
    - port: api
      path: /internal/v1/mof/metrics
      interval: 30s

메트릭

메트릭레이블의미
mof_processesmode최근 90초 동안 확인된 프로세스 수(모드별: all-in-one, web, worker).
mof_account_sync_last_success_timestamp_secondsaccount, provider, data청구서 / 리소스가 마지막으로 성공적으로 동기화된 시각. SyncAll은 둘 다에 반영됩니다.
mof_account_sync_failedaccount, provider, data해당 데이터의 최근 동기화가 실패하면 1.
mof_jobskind, state유형과 상태(available, running, retryable, discarded…)별 백그라운드 작업 수.
mof_license_expiry_timestamp_seconds / mof_license_valid라이선스 만료 시각과 유효 여부.
mof_mcp_requests_totalmethod, result원격 MCP 게이트웨이 호출 수.
mof_metrics_database_upMOF가 데이터베이스를 읽을 수 없으면 0.
mof_http_requests_totalmethod, route, codeAPI 요청 수. route는 라우트 템플릿(/v1/mof/prov/account/:accountId/bills)이므로 ID나 스캐너의 탐색 요청이 새 시계열을 만들지 않습니다. 알 수 없는 경로는 unmatched로 집계됩니다.
mof_http_request_duration_secondsmethod, routeAPI 지연 시간(히스토그램, 프로세스 간 합산 가능).
mof_users / mof_accountsstate / provider사용자 수(활성, 비활성)와 제공업체별 클라우드 계정 수.
mof_database_size_bytesdatabaseMOF가 관리하는 각 데이터베이스의 크기: Mof와 제공업체별 청구 데이터베이스. 청구 데이터베이스는 계정 수와 개월 수에 따라 커집니다.
go_sql_*, go_memstats_*, go_goroutines데이터베이스 연결 풀과 Go 런타임.

알림

mof-alerts.yml에 정의되어 있습니다. Prometheus가 평가하며, Alertmanager로 라우팅하거나 Grafana → Alerting에서 확인하세요.

알림조건
MofDownMOF가 2분 동안 스크레이프에 응답하지 않음.
MofDatabaseUnreachableMOF가 데이터베이스를 읽을 수 없음.
MofAccountSyncFailing계정의 청구서 또는 리소스 동기화가 계속 실패함(30분).
MofAccountSyncStale36시간 동안 계정의 청구서 또는 리소스 동기화가 한 번도 성공하지 않음.
MofJobsDiscarded지난 1시간 동안 백그라운드 작업이 최종 실패함.
MofJobBacklog50개가 넘는 작업이 30분 동안 대기 중: Worker를 추가하거나 멈춘 작업이 있는지 확인하세요.
MofHighErrorRate10분 동안 API 요청의 5% 이상이 5xx로 실패함.
MofLicenseExpiring라이선스가 14일 이내에 만료됨.