Harness Atlas

COURSE 03 · Agent Governance & Operations

Observability:中を見える化する

動いているエージェントの中を、トレースとメトリクスで観測する。OpenTelemetryのGenAI向け規約が、エージェント実行やツール呼び出しを共通の形で表す。まだ発展途上の領域。

これは詳細編のレッスンです。コース全体の見取り図は、入口のAgent Governance & Operationsとは何かから読むと流れがつかめます。

記録の次は、観測

前の監査は「あとからたどる」記録でした。Observability(可観測性)は、そこから一歩進んで、動いている最中の中身を見える化します。どのエージェントが、どのモデルを呼び、どのツールをどれだけ使い、どこで時間やトークンを費やしているか。遅い・失敗する・ループするといった不調を、推測ではなく観測でつかむためです。

共通の形で測る

ばらばらの計測では、ツールをまたいで比べられません。そこで共通の規約が要ります。業界では、OpenTelemetryのGenAI向けセマンティック規約が、その土台になりつつあります。エージェントの実行やツール呼び出しを、決まった名前のスパンで表します。たとえば、1回の実行を表す invoke_agent、モデル呼び出しの chat、ツール実行の execute_tool。トークン使用量やツール名などの属性も定められています。

ただし注意が要ります。このGenAI規約は、調査時点(2026年11月)ではまだ発展途上(Development/実験的)です。2026年に専用リポジトリへ移されて個別に版管理される段階で、安定版はこれからです。だから、名前や属性は今後変わる前提で扱い、採用時は最新の仕様を確認してください。

ガバナンスの最後のピース

Observabilityは、ここまでの柱を締めくくります。Identityで「誰か」を、Policyで「何をしてよいか」を、実行環境で「安全に動かす」を、Data Catalogで「どのデータか」を、監査で「あとからたどる」を整えました。Observabilityは、それらが実際にどう動いているかを見えるようにし、問題を早く見つけて直す回路を作ります。

1回の実行を共通の形で観測(OpenTelemetry GenAI・発展途上) invoke_agent(実行全体) chat(モデル呼び出し) execute_tool(ツール実行) スパンで、時間・トークン・ツール名などを測る
エージェントの実行を共通の形(invoke_agent の下に chat や execute_tool)で観測する。OpenTelemetryのGenAI規約が土台になりつつあるが、まだ発展途上。

ここまでのまとめ

これで、6つの柱(Identity・Policy as Code・セキュアな実行環境・Data Catalog・監査・Observability)が出そろいました。個人の道具を、組織全体で安全に運用する基盤へ引き上げるための柱です。

次に読む

次は各ハーネスのガバナンスを比べるで、この6つの観点を、Claude Code・Codex・Cursor・Devin の実際のしくみに当てて見比べます。

さらに読む(一次情報・調査時点)

  • OpenTelemetry(GenAIセマンティック規約は発展途上。最新の状況を確認してください)
  • Open Policy Agent(Policy as Codeの汎用エンジン)

前のレッスンコースへ戻る次のレッスン