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