MOF 提供 Prometheus 指標:程序、帳單和資源是否在同步、背景工作、License、HTTP 和 MCP 流量。可以在旁邊加一套 Prometheus + Grafana,也可以接入你既有的。
- 需求
- 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 連接埠只對自己的網路開放。
- 約多用 300 MB 記憶體,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、路徑),依註解探索 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 | License 到期時間,以及是否有效。 | |
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 延遲(histogram,可跨程序合併計算)。 |
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 | 過去一小時有背景工作徹底失敗。 |
MofJobBacklog | 超過 50 個工作排隊 30 分鐘:增加 Worker,或檢查是否有卡住的工作。 |
MofHighErrorRate | 10 分鐘內超過 5% 的 API 請求回傳 5xx。 |
MofLicenseExpiring | License 將在 14 天內到期。 |