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대시보드 가져오기
- 브라우저에서
http://SERVER_IP:3000에 접속해 admin / admin으로 로그인하고 새 비밀번호를 설정합니다. - 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_processes | mode | 최근 90초 동안 확인된 프로세스 수(모드별: all-in-one, web, worker). |
mof_account_sync_last_success_timestamp_seconds | account, provider, data | 청구서 / 리소스가 마지막으로 성공적으로 동기화된 시각. SyncAll은 둘 다에 반영됩니다. |
mof_account_sync_failed | account, provider, data | 해당 데이터의 최근 동기화가 실패하면 1. |
mof_jobs | kind, state | 유형과 상태(available, running, retryable, discarded…)별 백그라운드 작업 수. |
mof_license_expiry_timestamp_seconds / mof_license_valid | 라이선스 만료 시각과 유효 여부. | |
mof_mcp_requests_total | method, result | 원격 MCP 게이트웨이 호출 수. |
mof_metrics_database_up | MOF가 데이터베이스를 읽을 수 없으면 0. | |
mof_http_requests_total | method, route, code | API 요청 수. route는 라우트 템플릿(/v1/mof/prov/account/:accountId/bills)이므로 ID나 스캐너의 탐색 요청이 새 시계열을 만들지 않습니다. 알 수 없는 경로는 unmatched로 집계됩니다. |
mof_http_request_duration_seconds | method, route | API 지연 시간(히스토그램, 프로세스 간 합산 가능). |
mof_users / mof_accounts | state / provider | 사용자 수(활성, 비활성)와 제공업체별 클라우드 계정 수. |
mof_database_size_bytes | database | MOF가 관리하는 각 데이터베이스의 크기: Mof와 제공업체별 청구 데이터베이스. 청구 데이터베이스는 계정 수와 개월 수에 따라 커집니다. |
go_sql_*, go_memstats_*, go_goroutines | 데이터베이스 연결 풀과 Go 런타임. |
알림
mof-alerts.yml에 정의되어 있습니다. Prometheus가 평가하며, Alertmanager로 라우팅하거나 Grafana → Alerting에서 확인하세요.
| 알림 | 조건 |
|---|---|
MofDown | MOF가 2분 동안 스크레이프에 응답하지 않음. |
MofDatabaseUnreachable | MOF가 데이터베이스를 읽을 수 없음. |
MofAccountSyncFailing | 계정의 청구서 또는 리소스 동기화가 계속 실패함(30분). |
MofAccountSyncStale | 36시간 동안 계정의 청구서 또는 리소스 동기화가 한 번도 성공하지 않음. |
MofJobsDiscarded | 지난 1시간 동안 백그라운드 작업이 최종 실패함. |
MofJobBacklog | 50개가 넘는 작업이 30분 동안 대기 중: Worker를 추가하거나 멈춘 작업이 있는지 확인하세요. |
MofHighErrorRate | 10분 동안 API 요청의 5% 이상이 5xx로 실패함. |
MofLicenseExpiring | 라이선스가 14일 이내에 만료됨. |