2026 年 OpenClaw ゲートウェイ Prometheus メトリクス、Grafana ダッシュボード、launchd 連携アラート：MacLogin クラウド Mac 実践ガイド
香港・東京・ソウル・シンガポール・米国リージョンで Apple Silicon ゲートウェイを借り受けるチームは、すでに /health/ready への curl に慣れているはずですが、「請求が跳ねるまで快調だった」という形で障害が来ることがあります。 本稿（2026 年 5 月）は、OpenClaw の診断 Prometheus テキストを標準互換スクレイパで取得し、Grafana に SLO パネルを配線し、5 分 FOR 窓でジッターを吸収しつつ、launchd の ThrottleInterval と衝突しない運用をまとめます。 構造の異なる比較表が 2 枚、具体パラメータ付きの 9 ステップ、Prometheus / Grafana Alerting に貼れる閾値例が揃います。
先に読む：curl ループ監視、JSONL ローテーション、doctor 診断、ハブ OpenClaw 特集。公開導線：ヘルプ、料金、VNC。
Prometheus 型カウンタが curl では見えない死角をどう暴くか
合成チェックは「ソケットを受理したか」を答え、カウンタは「直近 30 分のツール失敗率が上がったか」を答えます。上流 LLM がレート制限に入っても HTTP 200 が続く局面では、トレンド指標だけが早期警報になります。上流ドキュメントで触れられる diagnostics-prometheus 系プラグインは、ゲートウェイと同一マシンから取得できるテキスト形式で系列を公開し、Webhook 本文を第三者 SaaS に送らずに可観測性を高められます。
- 遅延の歪み：ヒストグラム／分位点近似で p95 劣化を先取り。
- トークン経済：USD コスト系カウンタでテナント別燃焼を財務と突合し、多くの Mac mini M4 レンタルで一般的な 512 GB SSD クラスとも整合。
- チャネル健全性：上流でしばしば言及される 5 分単位のステール検知とスクレイプ周期を揃え、Grafana 保持 15 日しかないのに 12 秒スクレイプする非効を避ける。
シグナル源マトリクス
| ソース | 最適用途 | カーディナリティ | 避ける場面 |
|---|---|---|---|
/api/diagnostics/prometheus | SLO・エラーバジェット | テナントラベル爆増で高い | 無認証の平文公開 |
/health/ready / live | オーケストレーションゲート | 低い | 深い依存診断 |
openclaw health --json | インシデント橋渡し | なし | 亜分連続ポーリング |
openclaw doctor | 設定ドリフト | なし | リアルタイム飽和 |
安全なスクレイプパス
localhost ハードニング と同じく、Prometheus / vmagent はゲートウェイと同一ユーザ文脈で 127.0.0.1 を叩くか、観測 VPC へ SSH トンネルを張るのが安全です。シンガポールのオペレータが東京 mini を見るような跨りでは、アラート FOR に 180 ms 相当の RTT 余白を織り込んでください。
9 ステップ展開
- 5/7 ランブック の既存プローブ周期（例 90 s）を棚卸し。
- 診断 Prometheus を有効化し
# HELP行を確認。 - Grafana と同じ認証ヘッダで
curl --failを煙検証。 region="jp"など地域ラベルのみ—Webhook 秘密をラベル化しない。- Prometheus ジョブは既定 30 s、CPU 遊びが 25% を超えるまで 15 s に下げない。
- Grafana JSON を HK/JP/KR/SG/US フォルダへ取り込み datasource UID を固定。
- アラートは 5 m FOR を標準化。
- ゲームデイで認証情報を壊し、プローブとメトリクスのアラート順序を確認。
- 月次で未使用系列を削除し WAL を小ディスクでは 4 GB 未満に抑える。
Grafana パネルと再利用可能な閾値
| 目的 | PromQL スケッチ | 閾値 | 根拠 | オーナー |
|---|---|---|---|---|
| 失敗レート | rate(openclaw_run_completed_total{status="error"}[5m]) | > 0.05/s を 10 m | ツール連鎖失敗 | プラットフォーム |
| モデル遅延 | histogram_quantile(0.95, sum(rate(openclaw_model_call_duration_seconds_bucket[5m])) by (le)) | > 6 s を 5 m | SLA 前のスロットリング | AI 班 |
| ツール失敗件数 | increase(openclaw_tool_execution_total{status="error"}[15m]) | > 12 | 人手トリアージ量 | DevOps |
| コスト監視 | increase(openclaw_model_cost_usd_total[1h]) | > 48 USD/h | 暴走エージェントの財務通知 | FinOps |
launchd とディスク予算
Prometheus や Grafana Agent を LaunchAgent で同居させる場合、WAL 再実行失敗時に毎分 12 回再起動しないようクラッシュ対策記事の ThrottleInterval を再利用。JSONL SIEM の容量計算と合わせ、1 スクレイプ 780 KB × 40 ターゲットなら日 約 2.7 GB—保持期間か remote_write（60 s バッチ）を先に調整してから SSD 圧迫で unified logging が詰まるのを防ぎます。
クロスリンク
ブルーグリーン の注釈と Grafana アノテーションを同期し、Webhook 冪等性 で外部リトライと内部劣化を切り分けます。
FAQ
Grafana なしでも？ VictoriaMetrics のみでも可。Grafana は多職種の合意形成を速める UI 層です。
remote_write は Mac の外へ？ 出口課金を確認し、60 s シャーディングで帯域を半減させることが多いです。
doctor は不要になる？ LaunchAgent ラベル typo は doctor が依然として捕まえます。
なぜ Mac mini M4 がメトリクスエッジに向くか
Apple Silicon の消費電力曲線は常時スクレイプ sidecar に有利で、x86 のバースト型より運用が静かです。ネイティブ macOS 上で openclaw CLI、キーチェーン連携、Grafana キオスクを同居でき、ネストした仮想化を避けられます。MacLogin の HK/JP/KR/SG/US 配置によりゲートウェイを地域分割しつつダッシュボードは集中管理できますが、系列ラベルを正直に付け、シンガポールのネットワーク揺らぎとソウルの CPU 飽和をアラート本文で区別してください。
