クロッドコードモニタリング:捕獲許可の待機と欠落の結果

クロッドコードの監視には 3層が必要で ダッシュボードではなく 消費と活動のために公式のOpenTelemetryフィードを使用し,待機や端末故障のライフサイクルハック,実際に要求した結果に対するプロジェクトによるチェックを使用します. 3つ目のレイヤを省略すると セッションにはクリーンな痕跡があり ツール通話が成功し 予想されるパッチ テスト結果 ファイルがまだ欠けている間に 極度の反応が表示されます 合理的なデフォルトは故意に小さい. 編集されたメトリックとイベントを輸出し,フリーテキストの役に立たない6つのライフサイクルイベントを記録し,次に最後のイベントをタスク特定完成予測と比較して評価します. 実行に注意が必要かどうか判断するために 提示や原始ツールコンテンツを収集しないでください. このガイドは現在のクロードコード・スキームから設計を構築し,7回のセッションで決定順序をテストします ツール呼び出しは進歩であり,休憩は失敗であり, Stop は作業が完了であることを想定するものではありません. 3つの質問から始めましょう 監視は,各信号が1つの質問に答え,他の2つの質問に答えることを禁止するとより明確になります. 層 答えられる質問 信号 証明できないこと テレメトリ クロッド・コードは何を食ったのか? セッション,API要求,トークン,推定コスト,ツール結果,ツール決定,期間 求められた結果が正しいかどうか ライフサイクル なぜこのセッションは静かなのか? 許可要求,通知,背景タスク,予定された目覚め,停止,API終了ターン,セッション終了 ファイル,テスト,または外部結果が有効かどうか 結果 この 任務 は 約束 さ れ た 結果 を 与え まし た か. ファイルハッシュ,テスト終了状態,スケーマ検証,API応答,署名されたアーティファクト なぜセッションが待ったのか,費用がどれくらいかかっているのか 公式のクロードコード監視文書はOTel メトリックプロトコルを通じてメトリック,ログ/イベントを通じてイベント,およびオプションに分散したトラスを暴露します. 文書化されたメトリックには セッション数,ライン変更,コミット,プルリクエスト,アクティブタイム,トークン,推定コストが含まれます. イベントは即座の関連性,API結果,ツール結果,許可決定を追加します. これは最初の層に対する 優れた証拠です 完成契約ではありません 区別は通常の仕事において重要だ. Write ツールイベントが成功すると,書き込みが完了した. 意図されたファイルが正しい場所に書き込まれ プログラムがコンパイルしたり ユーザーがそのファイルを求めているとか書かれていません. 代償曲線は 消費量が流れていることを示しますが 低コストのセッションは 引き出物よりも一歩前に止まる可能性があります クロードコードハックでライフサイクル証拠を追加する クロッド・コードの ハック参照は,使用専用ダッシュボードに欠けている2番目の層を提供します. 4つのイベントは特に有用です PermissionRequest は,許可ダイアログが表示される前に起動します. 解決されていない最新事件の場合 セッションは人を待っています 停滞していません Stop は 主なエージェントが反応を終わると発射します 現在の入力には background tasks と session crons が含まれるため,停止したターンは,シェルタスク,サブゲント,モニタータスク,ワークフロー,MCPタスク,またはスケジュールされた目覚めを待っている可能性があります. StopFailure が Stop の代わりに,APIエラーがターンを終了すると起動します. 文書化されたエラークラスには,レート制限,オーバーロード,認証,請求,無効要求,欠けているモデル,サーバーエラー,最大出力トークンが含まれます. SessionEnd はセッションが終了した理由を記録する. 清掃や監査に役立つが,終了を阻止することはできません. PostToolUse , PostToolUseFailure , Notification ,および PreCompact は有用な文脈を追加します. 彼らの意味論を狭く保つ:最近の PostToolUse は活動の証拠である;繰り返される PostToolUseFailure はツールトラブルの証拠である; PreCompact は,後の行動と関連づけられる価値のある文脈移行を標的にします. 普遍的な健康上の判断ではありません プライバシー最小限のコレクターでは,タイムスタンプ,現地でハッシュされたセッション識別子,イベント名,ツール名,エラークラス,通知タイプ,および背景タスクまたは予定された覚醒のカウントのみを保持します. transcript path , cwd , last assistant message , Bash コマンド,ツール入力,および通知テキストを,診断された使用事例がそれらを正当化しない限り除外する. オフィシャル OTel デフォルトは同じ制限を支持します 自動テキスト,アシスタント応答テキスト,ツール・アルグメント,ツール・インプット/アウトプットコンテンツ,および原始 API コーディはデフォルトで無効です. OTEL LOG RAW API BODIES を有効にするには,会話の全履歴が表示されます. それは決して偶然のトラブルシューティングスイッチではありません. 最新の証拠を州に変える 下の決定命令は 検査するのに十分小さい. 各セッションにおける最後のイベントを分類し,ターン停止時に outcome verified を外部検証器が供給する. 命令は意図的だ 端末 API 障害は最近の活動イベントを上回ります 未解決の承認が待っています タイムアウトではありません Stop のイベントが完了として扱われることを防ぐ背景作業. これらのケースが除外された後のみ,検証者は complete と outcome missing の間で決定する. 保存された試験装置は7回のセッションと15分間の例の限界を使用します. 固定タイムスタンプで装置を実行すると,すべての7行が再現されます. これは決策のルールで 生産の妖怪ではありません 15分間の限界は 2分間のリントワークと 2時間間のビルドに間違っています 作業の予想されたカデンスと期間から新鮮さを設定し,欠けているまたは矛盾する証拠のために uncertain 経路を保持します. 会話の外での完成を定義する 分類の唯一のアプリケーション特別の入力は outcome verified です. 決定的なチェックから来るべきであり,最終的なアシスタントメッセージで doneを検索するのではなく. コード変更の作業では,有用な完了は,以下のすべてを必要とします. 1. 期待されるファイルは,開始コミットとは異なる. 2. 焦点テストコマンドが成功して終了する. 3. 生成されたアーテファクトのデコードまたはパッケージは輸入可能である. 4. 結果は承認されたリポジトリおよび適用範囲内に残る. ドキュメンテーションタスクでは,目的ファイル,フロントマテールまたはスケーマ認証,すべての引用されたローカルパス,およびリポジトリがすでに信頼しているすべてのリンクチェックを要求します. データ輸出については,期待されたファイルを確認し,解析し,必要な列を検証し,行数をソース境界と比較します. API の変更については,単に返却された HTTP 要求を承認する代わりに契約テストを実行してください. モニターは検証者の名前,出口状態,観測時間,および結果の消化を保存すべきであり,捏造された説明ではない. 決定学的予告が存在しない場合, outcome unknown を記録する. 未知の結果が再検討を要請する可能性があります. 次の安全な行動への警告 7州には7つのアラーム音が 必要ない 各状態を最小の有用なアクションに導きます: 州 デフォルトアクション working 何もしない waiting human 許可カテゴリーを持つ責任者に対し,許可を承認することなく通知する. waiting background 依存性と新鮮さを示し,セッションを再開しないでください. failed: エラークラスと制限された再試行方針を公開する outcome missing 失敗した完成を示し,検査のために作業を保存する stalled 1つの制限されたスプッシュを提案する前に,アクセシビリティと予想された期間を再確認する complete 証拠を保持し,問題を取り締まる このルーティングは 2つの高価な間違いを防ぐ. まず 権威を 正しく待っている 代理人を再試することから 遠ざかります 2つ目は プロジェクトの証拠が 成果が欠けていると示しているときに 会話の停止を祝うのを避けることです 自動復旧は監視よりも 厳格な境界線が必要です 速度制限障害はバックオフの後で復旧可能であり,認証障害は通常,人が必要であり,許可提示は,古いためだけに自動承認されるべきではない. 介入後 完成予測を再開する 成功したコマンドは 活動の証拠であり 元の任務が回復した証拠ではありません デザインを過剰収集せずに適用する 実践的な展開は 段階的なままでいい 1. クロードコードのテレメトリをメトリックとイベントで有効にして,すべてのコンテンツログのスイッチをオフにします. 2. claude code.session.count または claude code.user prompt が収集者に届いたことを確認する 3. PermissionRequest , Stop , StopFailure , Notification , PreCompact ,および SessionEnd のためのローカルハックを追加する. 4. ローカルにハッシュ識別子,ドロップパス,フリーテキストを標準化します 5. ある結果的なタスクのための決定的な完了予告を定義する. 6. 州ごとに合成イベントを再現して 誰にも知らせる前に 7. 警告は,その所有者と安全な次の行動が明示された場合にのみ追加します. バージョンは正常化器です クロードコードは複数のフィールドの最小バージョンを文書化しており,トランスクリプト内部は明らかに安定した契約ではない. 現在のドキュメントが暴露するハックとOTelフィールドを好む.端ピクセルをスクラップしたり,プライベート・トランスクリプトの形が変わらないと仮定して長持ちモニターを構築しないでください. Sidewispの有用な境界線 クロッド・コードは既に 強力な原始信号を 提供しています 作業のギャップは,これらの信号を抑制された健康決定に変えています. 作業,待機,失敗,時代遅れ,または約束された結果を見失い 証拠を示し,最も安全な次の動きです. Sidewisp は現在プライベートプレビュー段階です。 公開サイトと記事システムはライブですが,生産のクロードコードモニタリングアダプター,エージェント・ヘルスケア収集,および回復は一般的には出荷されていません. 意図された役割は,既存の実行時間とともに健康層であり,代替実行時間,必須モデルゲートウェイ,または自動固定装置ではありません. もしその境界線が プログラミングエージェントの操作方法と一致するなら プライベート・プレビューの待機リストは 次の適切なステップです それまでは,このガイドの3層のパターンは単独で使用できます:活動のためのテレメトリ,ライフサイクルのためのハック,結果のための決定的なチェック.