コンテンツにスキップ

バグレポートをローカルで確認する

Agentの診断結果を受け取った後、obscliを使用してチャット内容、ツール、LLMの診断結果、およびリソースメトリクスをオフラインで確認します。

obscli bug-report view ./report.zip

このコマンドは、ZIPファイルを検証し、ローカルURLを表示し、デフォルトのブラウザを開きます。ターミナルを稼働させておく必要があります。Ctrl+Cやプロセスの終了により、ローカルサービスは即座に停止します。ブラウザが自動的に開かないようにするには、以下のようにします:

obscli bug-report view ./report.zip --no-open

ローカルの ZIP ファイルを 1 つだけ指定できます。サービスは 127.0.0.1 のランダムなポートで待ち受け、別のアドレスには変更できません。URL のトークンは初回使用後に無効になり、同じブラウザーはセッション Cookie で接続を続けます。新しいブラウザーセッションにはコマンドを再起動してください。URL を転送しないでください。

完全オフライン状態と、生の証拠

ビューアーのページ、スタイル、スクリプトはすべて obscli に組み込まれています。CDN、外部フォント、テレメトリ、参照先の画像や添付ファイルは読み込みません。Markdown のリンク、画像、HTML は動作しないテキストとして扱い、コードブロックも実行しません。

ビューアーは、各ZIPエントリのCRCチェックを行い、ソースファイルのSHA-256値を表示します。ただし、ZIPファイルを変更したり、アーカイブ全体を抽出することはありません。パストラバーサル、重複するエントリ、予期しないファイルタイプ、CRCエラー、未知のスキーマ、マニフェストの不一致などは、明確に失敗と表示されます。

深度 3 のレポートは、機密性の高い UNREDACTED ファイルです。 業務上のテキスト、完全なプロンプト、推論、ツールデータ、インラインのマルチモーダルコンテンツが含まれる場合があります。管理されたマシンでのみ確認し、組織の機密データ取り扱い方針に従ってください。

セッションとLLMラウンド

左側には、未記録とされたカバレッジ項目を含むセッションの一覧が表示されます。メイン画面では、1 つのセッションのチャット、ツール、ランタイム、記録された LLM イベントを日時順に統合します。サブエージェントには親セッション、親呼び出し、ツール呼び出しの識別子が保持されます。レーンのチェックボックスで、現在のページのサブエージェントイベントを折りたためます。

時刻は既定でレポートの Agent のタイムゾーンを使用し、UTC またはブラウザーのローカル時刻に切り替えられます。検索は選択したセッションの元のイベントとデコードされたプロバイダーのバイト列を対象とし、イベントの種類、時刻、安定したソース位置を保持します。

各ページのイベント数には上限があります。Raw を展開すると、JSON、プロバイダーのバイト列、型付きデータをページごとに表示し、現在のページや選択した証拠をコピーできます。UTF-8 のページ分割では文字を保持します。デコードできないプロバイダーのチャンクは、base64 として明示します。

LLM ラウンド / 差分には、目的、試行、モデル、状態、使用量、合計遅延、最初のバイトまでの時間が表示されます。記録されたコンポーネントには、最終的なシステムテキストとセクション、有効なメッセージ、実際の末尾ユーザープロンプト、モデルパラメーター、ツール定義、順序付き応答チャンク、組み立てた応答、解析結果、ツールの証拠、圧縮履歴が含まれます。attempt_end は、取得できた最初のバイト、推論、最初のコンテンツ、推論トークンの時刻情報を記録します。欠けているネットワーク区間の情報は推測しません。

同じセッションからラウンドAとBを選び、構造化された差分を表示するためのコンポーネントを選んでください。JSONポインターは差分を識別し、配列の順序は保持され、長い値はコンポーネントまたはRawビューで完全な内容が表示されるプレビュー形式で表示されます。

従来の obsy-agent-bug-report@2 アーカイブも読み取れます。詳細な証拠は llm-diagnostics@1 がある場合にのみ表示されます。プロバイダーへのリクエスト、セクション、圧縮前の履歴、フェーズごとの遅延が欠けている場合は not recorded と表示します。会話記録や有効なコンテキストから実際のプロバイダーリクエストを再構築することはありません。

メトリクス

メトリクス画面には、CPU ticks/s、ヒープ/sys、goroutine、ファイルディスクリプター、ガベージコレクション、キューのグラフと、メトリクスやラベルの検索があります。LLM とツールのカウンターやヒストグラムは名前とラベルで選択できます。

カウンターの変化率には隣接するサンプルを使い、ヒストグラムの平均遅延には Δsum / Δcount を使います。最初のサンプル、カウンターのリセット、時刻の逆転、前の値の欠落、新しい呼び出しがゼロの場合には、区間値を生成しません。CPU ticks/s はコレクターの tick 単位を保持し、誤解を招く百分率には変換しません。

チャートの範囲をドラッグして、現在のセッションタイムラインをフィルタリングします。30秒前後のメトリクを確認するために、特定のタイムラインを選択します。LLMのラウンドでは、開始から終了までの間隔を選択できます。

ファイルとGoプロファイル

ファイルは、マニフェスト、環境/設定、ログ、実行時データ、JSON、およびテキストをツリー形式で表示します。テキストはページ形式で表示され、バイナリエントリーはメタデータのみを表示します。このファイルを保存する機能は、明示的に選択されたエントリのみをダウンロードし、ファイルを一括で抽出することはありません。

ビューアーには Go プロファイルやランタイムトレースの解析ツールは組み込まれていません。選択したファイルを保存し、インストール済みの Go ツールを使ってください。例:

go tool pprof ./heap.pprof
go tool pprof ./cpu.pprof
go tool trace ./runtime.trace

実際に保存されたパスを使用してください。診断用の全ディレクトリを公開分析サービスにアップロードしないでください。

フィードバック

このページは役に立ちましたか?