MOF mengekspos metrik Prometheus: proses, apakah tagihan dan resource tersinkron, job latar belakang, lisensi, serta trafik HTTP dan MCP. Tambahkan Prometheus dan Grafana di sampingnya, atau arahkan yang sudah ada ke MOF.
- Memerlukan
- MOF v2.0.14+
- Endpoint metrik
http://mof:8080/internal/v1/mof/metrics- Eksposur
- Hanya internal: Dash tidak meneruskan path ini.
Docker Compose
Menambahkan Prometheus dan Grafana di samping MOF. Prometheus sudah dilengkapi aturan peringatan MOF, Grafana sudah memakai Prometheus sebagai sumber datanya.
Unduh
Letakkan keduanya di samping compose.yaml Anda.
Mulai
docker compose -f compose.yaml -f compose.monitoring.yaml up -dImpor dasbor
- Buka
http://SERVER_IP:3000, masuk sebagai admin / admin, lalu atur kata sandi baru. - Dashboards → New → Import → Upload dashboard JSON file, lalu pilih mof-grafana-dashboard.json.
- Izinkan port 3000 hanya dari jaringan Anda sendiri.
- Sekitar 300 MB memori tambahan; Prometheus menyimpan data 15 hari. Image:
prom/prometheus:v2.53.1,grafana/grafana:11.1.0; Docker Compose v2.23+. - Sertakan kedua file juga pada perintah berikutnya (pull, up -d), atau layanan pemantauan akan terlewat.
Prometheus dan Grafana yang sudah ada
| File | Kegunaan |
|---|---|
| prometheus.yml ↓ | Job scrape untuk MOF. Prometheus harus dapat menjangkau port 8080 MOF melalui jaringan privat Anda. |
| mof-alerts.yml ↓ | Aturan peringatan; tambahkan di bawah rule_files. |
| mof-grafana-dashboard.json ↓ | Impor di Grafana dan pilih sumber data Prometheus Anda. |
Dengan beberapa proses web, masing-masing melaporkan nilai untuk seluruh deployment (proses, sinkronisasi, job); dasbor dan aturan memakai max(), jadi aman untuk men-scrape semuanya. Worker tidak melayani HTTP; pekerjaannya terlihat melalui proses web.
Kubernetes
Pod MOF membawa anotasi prometheus.io yang umum (scrape, port 8080, path), sehingga Prometheus yang menemukan Pod lewat anotasi akan mengambilnya. Dengan Prometheus Operator, tambahkan PodMonitor:
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: 30sMetrik
| Metrik | Label | Arti |
|---|---|---|
mof_processes | mode | Proses yang terlihat dalam 90 detik terakhir, per mode (all-in-one, web, worker). |
mof_account_sync_last_success_timestamp_seconds | account, provider, data | Kapan tagihan / resource terakhir berhasil disinkronkan. SyncAll dihitung untuk keduanya. |
mof_account_sync_failed | account, provider, data | 1 jika sinkronisasi terbaru data tersebut gagal. |
mof_jobs | kind, state | Job latar belakang per jenis dan status (available, running, retryable, discarded…). |
mof_license_expiry_timestamp_seconds / mof_license_valid | Kapan lisensi berakhir, dan apakah lisensi valid. | |
mof_mcp_requests_total | method, result | Panggilan ke gateway MCP jarak jauh. |
mof_metrics_database_up | 0 jika MOF tidak dapat membaca database-nya. | |
mof_http_requests_total | method, route, code | Permintaan API. route adalah template rute (/v1/mof/prov/account/:accountId/bills), sehingga ID dan pemindai yang menyelidik tidak menambah series; path yang tidak dikenal dihitung sebagai unmatched. |
mof_http_request_duration_seconds | method, route | Latensi API (histogram, dapat dijumlahkan antarproses). |
mof_users / mof_accounts | state / provider | Pengguna (aktif, dinonaktifkan) dan akun cloud per provider. |
mof_database_size_bytes | database | Ukuran setiap database yang dikelola MOF: Mof dan database tagihan provider, yang bertambah seiring jumlah akun dan bulan. |
go_sql_*, go_memstats_*, go_goroutines | Pool koneksi database dan runtime Go. |
Peringatan
Di mof-alerts.yml. Prometheus mengevaluasinya; rutekan dengan Alertmanager Anda, atau lihat di Grafana → Alerting.
| Peringatan | Kondisi |
|---|---|
MofDown | MOF berhenti merespons scrape selama 2 menit. |
MofDatabaseUnreachable | MOF tidak dapat membaca database-nya. |
MofAccountSyncFailing | Tagihan atau resource sebuah akun terus gagal disinkronkan (30 menit). |
MofAccountSyncStale | Tidak ada sinkronisasi tagihan atau resource sebuah akun yang berhasil selama 36 jam. |
MofJobsDiscarded | Job latar belakang gagal permanen dalam satu jam terakhir. |
MofJobBacklog | Lebih dari 50 job menunggu selama 30 menit: tambahkan worker atau cari job yang macet. |
MofHighErrorRate | Lebih dari 5% permintaan API gagal dengan 5xx selama 10 menit. |
MofLicenseExpiring | Lisensi berakhir dalam 14 hari. |