跳到內容
mofcloud

監控

最後更新於:

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

匯入儀表板

  1. 開啟 http://SERVER_IP:3000,用 admin / admin 登入並設定新密碼。
  2. 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_processesmode90 秒內上線的程序數,依模式(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_validLicense 到期時間,以及是否有效。
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 延遲(histogram,可跨程序合併計算)。
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 分鐘)。
MofAccountSyncStale某個帳號的帳單或資源 36 小時沒有同步成功。
MofJobsDiscarded過去一小時有背景工作徹底失敗。
MofJobBacklog超過 50 個工作排隊 30 分鐘:增加 Worker,或檢查是否有卡住的工作。
MofHighErrorRate10 分鐘內超過 5% 的 API 請求回傳 5xx。
MofLicenseExpiringLicense 將在 14 天內到期。