mcpField
G
gateway-diagnose

gateway-diagnose

github.com/joelhooksクラウド・DevOps6550 回インストール1 日前に更新
リポジトリ

gateway-diagnose について

gateway-diagnose は、ゲートウェイのリクエスト、イベント、実行、フローを調査するスキルです。障害の追跡、許可された復旧、配信確認を、プライベートデータを保護しながら進めます。

主な機能

  1. 01ゲートウェイ各段階のリクエスト追跡
  2. 02タイムスタンプ、ID、タイムアウトの比較
  3. 03障害原因の追跡
  4. 04許可された範囲限定の復旧
  5. 05動作確認と観測結果の報告

活用シーン

  1. 01ゲートウェイ配信失敗の調査
  2. 02キュー遅延とエージェント停止の判別
  3. 03プローブを行わない障害監査
  4. 04許可されたサービス復旧の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/joelhooks/joelclaw --skill gateway-diagnose

インストール後、Claude Code で/gateway-diagnoseを入力して読み込まれたか確認します。

詳細

ゲートウェイの診断

失敗したリクエスト、イベント、実行、またはフローの ID と、期待される動作を特定します。既存の証拠から調査を始めてください。診断を行うこと自体は、プローブメッセージの送信を許可するものではありません。

現在のゲートウェイのエントリーポイント、サービス設定、オーナーシップと運用手順書を確認します。サポートされているステータス、イベント、診断コマンドについては、joelclaw gateway --help を使用してください。依存関係をプローブする前にサービスの配置先を確認します。ローカルクラスターが存在しないことは、リモートで管理されている依存関係が失敗した証拠にはなりません。

実際の経路を追跡します。イングレス、永続キュー、ポリシー、ゲートウェイセッション、アダプター、配信確認です。タイムスタンプ、相関 ID、進行状況、設定済みのタイムアウトを比較してください。キューの経過時間だけでは、エージェントがハングしているとは断定できません。依存関係が劣化していても、チャネルやセッションの診断に役立つ場合があります。

最初に見つかった関連する障害を原因まで追跡します。監査の場合は、その内容を報告してください。認可された修復の場合は、その障害を修正し、独立した診断を続けてください。最初のプローブが失敗したというだけで、タスク全体を止めないでください。

設定済みのモデル、プロバイダー、プロセスオーナー、現在の起動元を使用してください。過去のエラー文字列は手がかりであり、古い組み込みコントローラー、ポーリングオーナーのリース、モデルの固定状態を復元する指示ではありません。

単一のトランスポートオーナーとゲートウェイオーナーを維持してください。競合するポーラーやゲートウェイを起動したり、アクセス制御を弱めたり、名前でプロセスを終了したり、共有チェックアウトをリセットしたりしないでください。認可されている場合は、オーナーサービスの対象を限定した再起動または復旧手順を使用してください。

影響を受けた動作を検証し、正確な観測結果を報告してください。キューへの送信が成功しても、配信された証拠にはなりません。診断レポートにトークン、非公開メッセージの生データ、認証ファイルを決して記載しないでください。

コメント