OpenClaw ゲートウェイ合成ヘルスチェック：curl ループ、JSONL ログ、レンタルクラウド Mac で launchd に優しい監視
本番インシデントは dramatic なスタックトレースから始まることは少なく、ゲートウェイが応答しなくなっても誰も気付かず Webhook キューが Slack を埋めるまで沈黙することが多いです。 合成プローブ—ループバックへの絞った curl、追記専用の構造化ログ、ThrottleInterval を尊重する LaunchAgent—は、香港・東京・ソウル・シンガポール・米国のオペレーターに、外部 SaaS に資格情報を渡さず正直な心拍を提供します。 2026年5月版では、localhost 拘束の上流ガイドと整合したプローブ間隔、失敗バジェット、採用の 9 ステップ、連続失敗時のエスカレーションをまとめます。
先に読む：localhost 拘束とハードニング、デーモントラブルシュート、カットオーバー時のヘルスチェック、ハブ OpenClaw 記事一覧。基点：ヘルプ、料金、VNC。
プローブは「監視ツールを増やす」ではなく「ゲートウェイがソケットを受け付けるという最小宣言」をインフラコードに固定する道具です。変更レビューでは間隔・タイムアウト・ログパスを必ず diff に含めてください。
合成プローブが「誰かが気付くだろう」より優れる理由
openclaw doctor は構成ドリフトを捉えますが秒単位の CPU を使います。軽量 curl は HTTP リスナーがソケットをまだ受け入れることを安価に証明し、TLS が SSH トンネル側で終端する構成でも意味があります。
ワンショットの手動 curl と定期プローブは別物です。後者はオンボーディング済みの macOS ユーザー文脈とログローテーションまで含めて設計してください。
ヘルスエンドポイント契約マトリクス
| スタイル | 期待シグナル | 偽陽性 | 緩和 |
|---|---|---|---|
| HTTP 200 空ボディ | リスナー生存 | accept() 後にプロセスが固着 | プロセス RSS などと併用 |
| JSON ステータス | バージョン＋ビルド刻印 | パース失敗が増える | jq の終了コードで判定 |
| WebSocket アップグレード試験 | フルスタック健全性 | 実装コストが高い | ティア 1 ゲートウェイのみ |
契約を変えるときはプローブとロールアウトを同一変更に束ね、ダッシュボードの色が変わる前にドキュメントを更新します。
すべてのプローブスクリプトに必要な curl ガードレール
--fail --silent --show-errorと明示的な接続・全体タイムアウト。- ループバック限定（
127.0.0.1）— TLS メッシュがある場合は設計書に記載。 - 構造化 stderr — ISO 時刻プレフィックス＋リース ID で grep しやすく。
冗長プローブが同一ホストでポート競合しないよう、運用ユーザーごとに plist を分離するチームもあります。
プローブ補助向け LaunchAgent スロットルパターン
launchd は終了コードが乱れるとプローブを連続再起動します。ThrottleInterval と健全な終了コードを揃え、過去のゲートウェイ復旧記事と同じクラッシュループ戒めを適用してください。
プローブ採用の 9 ステップ
- ベースライン： 何も変える前に doctor の JSON を保存。
- 固定： リスナーポート（多くの場合 18789）を SSH と並べてファイアウォール資料に記載。
- 作成： curl ラッパを IaC 隣にコミット。
- ドライラン： SSH セッションから手動実行。
- 設置： 正しい macOS ユーザーに LaunchAgent をインストール。
- 検証： JSONL の増え方とローテ方針。
- 配線： ドライラン成功後に PagerDuty／Webhook へ。
- ゲームデー： 意図的にゲートウェイを落としてアラートを確認。
- 振り返り： 閾値を四半期ごとに見直し。
失敗テストはビジネス時間外にスケジュールし、Webhook のスパム抑制設定もあわせて確認すると安心です。
JSONL 追記ログと SIEM ボリューム試算
1 分に 1 行なら年間約 52.5 万行—Webhook トレースに比べれば小さいものの、gzip ローテは JSONL ローテーション指針 に沿ってください。
SIEM に送る際はホスト名・テナント ID・プローブ名をフィールド化し、全文検索だけに頼らないようにします。
監視と信頼性関連記事への橋渡し
プローブは グレースフルシャットダウン訓練 とセットにし、メンテ窓が二重アラートを増やさないようにします。上流 LLM API が揺れるときは プロバイダ backoff ガイド とリトライ設計を突き合わせてください。
FAQ
プローブは認証できますか？ ループバック無認証を優先。必要なら bearer を launchd 環境に—リポジトリに直書きしない。
東京の監視者が米ログを読むときの RTT は？ 実測が先で、太平洋横断はしばしば 120 ms を超えます。アラート経路はジッターを許容する設計に。
フリートを増やす前に何を見る？ 監視ホストが飽和する前に 料金 でキャパ計画を。
プローブアンカーにレンタル Mac mini が現実的な理由
Apple Silicon のアイドル効率が良く、バックグラウンド curl のコストが低いままです。ゲートウェイを HK／JP／KR／SG／US に分散すれば地域障害を切り離せ、単一ミニへプローブ基数を二重化する必要も減ります。
