可観測性 · ゲートウェイ · リモートマック
オープンクロー可観測性実戦:トークンと認証をゲートウェイからスモーク要約へ
2026.04.21
ウェブ運用
約 9 分
00 導入と痛み
赤いスモークは画面だけでは半分。入出力トークンと認証結果を一行要約へ載せ経路と表示を分ける。
一 用量が見えず未認可とタイムアウトを混同する。
二 プレイライトの赤とゲートウェイ時刻がずれ相関が崩れる。
三 要約が長く再実行条件が拾えない。
可引用: 環境・版・時刻を先頭に三つ。
01 対照
| 観点 | 観測あり | 観測なし |
|---|---|---|
| 切り分け | 認証・用量・画面を三分割できる。 | 再実行頼みで溶ける。 |
| 再現 | 要約に数値と理由コードを載せられる。 | スクショだけでは経路が曖昧。 |
| 運用 | しきい値で静かと緊急を分けられる。 | 一チャンネルが騒がしい。 |
02 ゲートウェイ側の確認項目
六項を上から。コンソール不要、端末かヘルスで足りる。
- 同一オリジンでチャットとモデル一覧が応答するか。
- 認証形式と期限切れコードが分離しているか。
- 用量がリクエスト単位で増分し二重が無いか。
- 上流時刻と記録の差が許容内か。
- 失敗時にマスクと理由コードを返すか。
可引用: 五項を票へ貼る。
03 再現手順
- 固定: 環境名・版識別子・基準時刻をリモートマックでも同名にする。
- 取得: 用量と認証結果を一連で読み欠損を潰す。
- 実行: プレイライトを同じベースで走らせ失敗名を控える。
- 合成: 観測と失敗名を一行にしスクショ有無を括弧へ。
- 投稿: 汎用ウェブフックへ短文で送り鍵は伏せ字。
可引用: 五手をデプロイ後ランブックへ転記。
04 プレイライトレポート項目との突き合わせ
失敗行のケース名・所要・再試行と入出力トークン・認証コードを同じ分で並べる。数値ゼロで赤は待機、伸びで赤は経路を疑う。深掘りは最小再現へ。
05 しきい値アラート
用量は五分平均が基準の二倍で注意・三倍で緊急。認証は連続二回で別ルート。監視と整合。
06 フック雛形
短文で意味が読めれば足りる。
{"text":"【環境】【版】認証=◯ 入力=123 出力=456 失敗=ログイン導線 スクショ=有","dedupe_key":"環境-版-分-件名"}
ヘッダ併用は検証フックへ。
07 よくある質問
用量だけ大きい
再試行と二重計上を疑い増分定義を読む。
認証成功で画面が赤い
待機とセレクタを疑いプレイライト側へ。
要約が流れる
冪等鍵と接頭辞を固定し一覧型へ送る。