可観測性 · ゲートウェイ · リモートマック

オープンクロー可観測性実戦:トークンと認証をゲートウェイからスモーク要約へ

2026.04.21 ウェブ運用 約 9 分

想定:リモートマックのオープンクローゲートウェイでエンドツーエンドを回す担当。用量認証を要約へ。関連:モデルプレイライト

00 導入と痛み

赤いスモークは画面だけでは半分。入出力トークン認証結果を一行要約へ載せ経路と表示を分ける。

 用量が見えず未認可とタイムアウトを混同する。

 プレイライトの赤とゲートウェイ時刻がずれ相関が崩れる。

 要約が長く再実行条件が拾えない。

可引用: 環境・版・時刻を先頭に三つ。

01 対照

観点 観測あり 観測なし
切り分け 認証・用量・画面を三分割できる。 再実行頼みで溶ける。
再現 要約に数値と理由コードを載せられる。 スクショだけでは経路が曖昧。
運用 しきい値で静かと緊急を分けられる。 一チャンネルが騒がしい。

02 ゲートウェイ側の確認項目

六項を上から。コンソール不要、端末かヘルスで足りる。

  • 同一オリジンでチャットとモデル一覧が応答するか。
  • 認証形式と期限切れコードが分離しているか。
  • 用量がリクエスト単位で増分し二重が無いか。
  • 上流時刻と記録の差が許容内か。
  • 失敗時にマスクと理由コードを返すか。

可引用: 五項を票へ貼る。

03 再現手順

  1. 固定: 環境名・版識別子・基準時刻をリモートマックでも同名にする。
  2. 取得: 用量と認証結果を一連で読み欠損を潰す。
  3. 実行: プレイライトを同じベースで走らせ失敗名を控える。
  4. 合成: 観測と失敗名を一行にしスクショ有無を括弧へ。
  5. 投稿: 汎用ウェブフックへ短文で送り鍵は伏せ字。

可引用: 五手をデプロイ後ランブックへ転記。

04 プレイライトレポート項目との突き合わせ

失敗行のケース名所要再試行入出力トークン認証コードを同じ分で並べる。数値ゼロで赤は待機、伸びで赤は経路を疑う。深掘りは最小再現へ。

05 しきい値アラート

用量は五分平均が基準の二倍で注意・三倍で緊急。認証は連続二回で別ルート。監視と整合。

06 フック雛形

短文で意味が読めれば足りる。

{"text":"【環境】【版】認証=◯ 入力=123 出力=456 失敗=ログイン導線 スクショ=有","dedupe_key":"環境-版-分-件名"}

ヘッダ併用は検証フックへ。

07 よくある質問

用量だけ大きい

再試行と二重計上を疑い増分定義を読む。

認証成功で画面が赤い

待機とセレクタを疑いプレイライト側へ。

要約が流れる

冪等鍵と接頭辞を固定し一覧型へ送る。

スモーク検証向けリモート Mac