エージェント可観測性:OpenTelemetry で「ブラックボックス Agent」を「説明可能なパイプライン」に

OpenTelemetry 仕様(CNCF プロジェクト)は traces・metrics・logs を横断的標準として定義し、Semantic Versioning 2.0 で管理されます。Codex のドキュメントも Tracing と Observability and usage を独立モジュールとして列挙しています。

ObservabilityTracingOpenTelemetryTelemetryCNCF

エージェントが失敗したとき、最も難しいのは修正ではなく再現です。結果が間違っていることは分かっても、どのステップ・どのツール呼び出し・どの分岐で逸れたかが分からない。OpenTelemetry は traces・metrics・logs の3本柱で答えます。

『Agent Harness 完全習得』では、可観測性は「本番対応」の最初の関門です。『Codex 入門』では、トークン消費とステップ軌跡を読み、失敗時に trace から該当ステップを特定することを学びます。