← 概念解説に戻る

Concept Fable

スパン

先に結論:Span(スパン)はTrace内の一回の具体的な操作記録である。通常、一回のモデル呼び出し、検索、ツール呼び出し、データベース照会、解析、承認、または中間ステップを表し、開始時刻、終了時刻、所要時間、入出力、状態、エラー、関連コンテキストを含む。複数のspanが組み合わさって、一回の完全なtraceを構成する。

Span · Observability artifact

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

寓話

長い紙に押された、無視された小さな印章

カモメ郵便局が各小包に完全な経路を残すようになってから、局長はようやく小包が窓口から受取人の手に渡るまでの全過程を見られるようになった。皆は問題が解決したと思った。長い紙がまだあれば、小包が理由もなく消えることはもうないだろうと。

しかし新たな問題が現れた。多くの荷物は失踪しておらず、ただ遅かった。長い紙はそれらが全程を走り終えたことを示していたが、どの区間が遅らせたかは説明していなかった。局長は一連の印章を見て、こう言うしかなかった:この便は二日半かかった。称重、仕分け、船積み、転送のどこで遅れたかは、依然として不明だった。

老郵便配達人は彼にこう念を押した。今お前には道があるが、まだ各区間を測るものがない。長い紙は荷物がどこを通ったかを教えてくれる。一つ一つの印章だけが、その一歩で実際に何が起きたかを教えてくれる。

そこで郵便局は印章を改めた。以前は一つの印に「処理済み」とだけ書いたが、今はどの印にも四つのことを書く:開始時刻、終了時刻、処理者、結果。このステップが他の倉庫を呼び出し、他の帳簿を調べ、他の車を待ったなら、それも印の横に書く。

新しい印を初めて使うと、問題がすぐに浮かび上がった。一箱の磁器が櫃から倉庫まで行くのに一刻しかかからなかったが、倉庫から埠頭までは五時辰も待った。埠頭の印を見ると、原因は船が遅いことではなく、包装再検査がずっと順番待ちしていたことだった。包装再検査という小さな事柄は、これまでの「処理済み」の三文字の中に隠れていた。

別の時、荷物は仕分けが速いと表示されていましたが、仕分け印の横に「三回リトライ」と書かれていました。局長はそこで初めて知りました。仕分け員は実は連続して目的地を間違えて調べており、最後の一度だけ正しく調べたため、結果だけ見れば成功に見えていたのです。この細かい印がなければ、成功が過程の不安定さを覆い隠してしまいます。

ゆっくりと、郵便局は一枚一枚の印を最小の分析単位と見なし始めた。経路全体をジャーニーと呼び、各印をセグメントと呼ぶ。ジャーニーを最適化するには、終点だけを見てはいけない。まずどのセグメントが遅いか、どのセグメントが誤っているか、どのセグメントが最も多くリトライされるかを知る必要がある。

後に局長は言った。長い紙は荷物の一生を見せてくれ、小さな印はその一息一息を見せてくれる。長い紙がなければ全体がわからず、小さな印がなければ細部がわからない。

明らかにする

この物語が語るのは:スパン

Span(スパン)はTrace内の一回の具体的な操作記録である。通常、一回のモデル呼び出し、検索、ツール呼び出し、データベース照会、解析、承認、または中間ステップを表し、開始時刻、終了時刻、所要時間、入出力、状態、エラー、関連コンテキストを含む。複数のspanが組み合わさって、一回の完全なtraceを構成する。

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

メタファーのマッピング

  • 長い紙:Trace、一度のエンドツーエンド実行経路
  • 各印章:Span。実行パスにおける単一の操作
  • 「処理済み」とだけ書く:細かいspan情報がなく、遅延やエラーを分析できない
  • 開始時間と終了時間:span の時間境界、遅延計算に使用
  • 処理人と結果:span の実行コンポーネント、状態、出力
  • 包装確認の待ち行列:あるサブステップが全体の遅延を引き起こす
  • 3回リトライして最終的に成功:spanは最終成功の背後にある不安定なプロセスを明らかにできる
  • 最小分析単位:span は Agent タスクの詳細を調査する基礎的な粒度

Andy(任旭)判断

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

traceOpenTelemetrylatencyinstrumentationobservability
京ICP备2026014272号