コンテンツにスキップ
mofcloud

監視

最終更新日:

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

ダッシュボードをインポート

  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、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_processesmode直近 90 秒以内に確認されたプロセス数(モード別: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_validライセンスの終了日時と、有効かどうか。
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 レイテンシ(ヒストグラム、プロセス間で合算可能)。
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直近 1 時間にバックグラウンドジョブが最終的に失敗した。
MofJobBacklog50 件を超えるジョブが 30 分間待機している:Worker を追加するか、停止しているジョブがないか確認してください。
MofHighErrorRateAPI リクエストの 5% 超が 10 分間 5xx で失敗している。
MofLicenseExpiringライセンスの期限が 14 日以内に切れる。