Lewati ke konten
mofcloud

Pemantauan

Terakhir diperbaharui:

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

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

Impor dasbor

  1. Buka http://SERVER_IP:3000, masuk sebagai admin / admin, lalu atur kata sandi baru.
  2. 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

FileKegunaan
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:

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

Metrik

MetrikLabelArti
mof_processesmodeProses yang terlihat dalam 90 detik terakhir, per mode (all-in-one, web, worker).
mof_account_sync_last_success_timestamp_secondsaccount, provider, dataKapan tagihan / resource terakhir berhasil disinkronkan. SyncAll dihitung untuk keduanya.
mof_account_sync_failedaccount, provider, data1 jika sinkronisasi terbaru data tersebut gagal.
mof_jobskind, stateJob latar belakang per jenis dan status (available, running, retryable, discarded…).
mof_license_expiry_timestamp_seconds / mof_license_validKapan lisensi berakhir, dan apakah lisensi valid.
mof_mcp_requests_totalmethod, resultPanggilan ke gateway MCP jarak jauh.
mof_metrics_database_up0 jika MOF tidak dapat membaca database-nya.
mof_http_requests_totalmethod, route, codePermintaan 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_secondsmethod, routeLatensi API (histogram, dapat dijumlahkan antarproses).
mof_users / mof_accountsstate / providerPengguna (aktif, dinonaktifkan) dan akun cloud per provider.
mof_database_size_bytesdatabaseUkuran setiap database yang dikelola MOF: Mof dan database tagihan provider, yang bertambah seiring jumlah akun dan bulan.
go_sql_*, go_memstats_*, go_goroutinesPool koneksi database dan runtime Go.

Peringatan

Di mof-alerts.yml. Prometheus mengevaluasinya; rutekan dengan Alertmanager Anda, atau lihat di Grafana → Alerting.

PeringatanKondisi
MofDownMOF berhenti merespons scrape selama 2 menit.
MofDatabaseUnreachableMOF tidak dapat membaca database-nya.
MofAccountSyncFailingTagihan atau resource sebuah akun terus gagal disinkronkan (30 menit).
MofAccountSyncStaleTidak ada sinkronisasi tagihan atau resource sebuah akun yang berhasil selama 36 jam.
MofJobsDiscardedJob latar belakang gagal permanen dalam satu jam terakhir.
MofJobBacklogLebih dari 50 job menunggu selama 30 menit: tambahkan worker atau cari job yang macet.
MofHighErrorRateLebih dari 5% permintaan API gagal dengan 5xx selama 10 menit.
MofLicenseExpiringLisensi berakhir dalam 14 hari.