MOF は Prometheus メトリクスを公開しています:プロセス、請求データとリソースの同期状況、バックグラウンドジョブ、ライセンス、HTTP と MCP のトラフィック。Prometheus と Grafana を横に追加するか、既存の環境から MOF を参照させます。
- 要件
- 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、path)が付いているため、アノテーションで 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 | ライセンスの終了日時と、有効かどうか。 | |
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 レイテンシ(ヒストグラム、プロセス間で合算可能)。 |
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 | 直近 1 時間にバックグラウンドジョブが最終的に失敗した。 |
MofJobBacklog | 50 件を超えるジョブが 30 分間待機している:Worker を追加するか、停止しているジョブがないか確認してください。 |
MofHighErrorRate | API リクエストの 5% 超が 10 分間 5xx で失敗している。 |
MofLicenseExpiring | ライセンスの期限が 14 日以内に切れる。 |