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 天内到期。 |