← 概念解説に戻る

Concept Fable

OpenTelemetry

先に結論:OpenTelemetry, OTel はベンダー中立の観測標準であり、traces、metrics、logs を収集するために使う。LLM/Agent アプリケーションは OTel を使い、フロントエンドのリクエスト、検索、モデル呼び出し、ツール実行、データベース操作を統一されたチェーンにつなぎ、単一の観測プラットフォームへのロックインを減らせる。導入時には通常、モデル、token、prompt バージョン、ツール名、コストなどの LLM セマンティックフィールドを追加する必要がある。

OpenTelemetry, OTel · Observability standard

まず物語を読む。ここでは急いで定義を示さず、まず問題そのものを立ち上がらせる。

寓話

各社の時計がついに同じ目盛りを使うようになった

銀鐘鎮には多くの工房があり、それぞれが時間を記録していた。薬舗は香が何寸燃えたかを使い、埠頭は潮汐の刻線を使い、工房は砂時計を使った。普段は十分だが、事故の振り返りでは食い違う。ある都市間注文が失敗し、客服は返信が遅いと言い、倉庫はツールは正常と言い、機関舗は遅延は高くないと言った。どの家にも記録があるが、形式、時間、名前が一致しない。鎮長はまず全員に記録簿を経理係に送らせた。経理係は山ほどの紙を受け取ったが、依然としてつなげられなかった:同じリクエストが異なる整套装置では異なる番号を持つ。

後に、時計修理職人が統一した目盛りを提案した。各ステップに同じ追跡番号が付き、各作業は span として書かれ、重要な数値は metrics になり、イベントと記録簿は共通のセマンティクスで記録された。

この目盛りは特定の一工房のものではない。今日は甲の看板、明日は乙のストレージに切り替えても、記録方式は継続できる。商隊は単一のツールに縛られない。

接続後、装置全体をまたいだトラブルシューティングがずっと速くなった。あるヘルパーのリクエストは、フロントエンドから検索、機関、ツール、総帳櫃までの経路を一本の線としてつなげられる。

工匠は 長信匠 シナリオにも意味を補足した。機関名、字粒の数、prompt バージョン、検索数、ツール名、エラーコード。標準の目盛りは新しい仕事をカバーできなければならない。

銀鐘鎮は最後に理解しました。観測データの価値は収集だけでなく、チームを越え、サプライヤーを越え、設備全体を越えて整合できることにあるのです。

時計職人はまた、誰も自分の暗号を町全体の規則にしてはならないと定めた。薬舗は薬名を、埠頭は船番を保持したければ保持してよいが、共通の目盛りは、それらが同じ注文を指していることを他人に知らせなければならない。

初めて本当に役立ったのは、一批の薬材が遅れた時だった。皆が同じ番号をたどり、受付、倉庫、車隊から外城の駅まで調べて、ようやく3回目の積み替えで遅れていると分かった。鎮長は言った。記録が同じ言葉を話せてこそ、振り返りは互いの言い訳合戦にならない。共通の目盛りがなければ、記録が増えるほど口論が増えるだけだ。目盛りがあれば、遅れ、誤り、断絶にそれぞれの位置がある。

明らかにする

この物語が語るのは:OpenTelemetry

OpenTelemetry, OTel はベンダー中立の観測標準であり、traces、metrics、logs を収集するために使う。LLM/Agent アプリケーションは OTel を使い、フロントエンドのリクエスト、検索、モデル呼び出し、ツール実行、データベース操作を統一されたチェーンにつなぎ、単一の観測プラットフォームへのロックインを減らせる。導入時には通常、モデル、token、prompt バージョン、ツール名、コストなどの LLM セマンティックフィールドを追加する必要がある。

重要なのは、それが単なる用語ではなく、実際のAI/Agentシステムで繰り返し現れる構造的な問題だという点だ。これを理解して初めて、いつモデルを足すべきか、いつプロセスを変えるべきか、いつガバナンスを補うべきかを判断できる。

メタファーのマッピング

  • 各システムの時間記録:異なるシステムの私有ログ形式
  • 統一追跡番号:trace id
  • 各作業を span として記述:OpenTelemetry span
  • 重要な数値:metrics
  • ベンダー中立性:OTel のポータビリティ
  • LLM セマンティックフィールド:Agent 向けの観測拡張

Andy(任旭)判断

この概念の実戦的価値は、「賢く見えるAI機能」を納品可能、検収可能、ガバナンス可能な作業単位に分解する手助けをすることです。

トレースspansmetricslogsobservabilityLangfusePhoenix
京ICP备2026014272号