← 概念解説に戻る

Concept Fable

可観測性

先に結論:可観測性とは、ログ、メトリクス、トレース、イベントを通じてシステムの内部状態を理解する能力である。Agent システムにとって、可観測性はタスクの成功または失敗を知るだけではなく、モデル呼び出し、検索、ツール呼び出し、パラメータ、遅延、エラー、コスト、中間出力を振り返れることである。これによりチームは問題を特定し、行動を説明し、性能を最適化し、事故発生時に迅速に復旧できる。

Observability · Operations / reliability

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

寓話

時計が止まったのは見えるが、どの歯車が先に詰まったかはわからない

銀鐘鎮の広場には大きな鐘があります。毎朝時を告げ、商店は開き、学校は授業を始め、港は船を出し、町全体が鐘の音に合わせてリズムを整えます。町民は鐘の仕組みは知りませんが、鐘が鳴ればすべて正常だと知っています。

ある朝、大鐘が鳴らなかった。町長はすぐに鐘修理師を呼んだ。修理師は鐘楼に登り、針が五点四十七分で止まっているのを見た。町長が問う:どこが壊れた?修理師は言う:今わかるのは止まったことだけで、なぜ止まったかはわからない。

町長は非常に不満だった。彼は言った。時計が止まったのは明らかではないか。直せばいいだけだ。時計職人は首を振った。針をただ戻すだけなら、午後また止まるかもしれない。適当に歯車を替えれば、良い部品を替えてしまうかもしれない。我々が見ているのは結果であって、原因ではない。

かつて銀鐘鎮では、時計の修理は経験に頼っていた。音を聞き、温度を触り、摩耗を推測する。老師匠がいるときはほとんど直せたが、老師匠が病むと、新人は一つ外して試し、また戻すしかなかった。毎回の修理は黒箱を手探りするようだった。

後に、新しい修鐘匠は大鐘に三つのものを加えた。第一は小さな刻痕で、各歯車が一回転するたびに記録を残す。第二は細い銅線で、どの伝動が遅くなったかを示せる。第三は油盏の印で、どこで摩擦が急増したかが分かる。

町の人々は最初、こうしたものは余計だと思っていた。彼らは鐘が鳴るかどうかだけを気にし、歯車が何回転したかなど誰も気にしなかった。だが次に大鐘がまた半刻遅れた。時計職人は時計全体を分解せず、記録を見ただけで気づいた。主歯車が壊れたのではなく、三層目の小さな軸受が雨の後に渋くなり、その後のすべてが遅くなっていたのだ。

今回は、時計修理は半時しかかからなかった。さらに重要なのは、時計修理師が鎮長にこう告げられたことだ。もしこの軸受を交換しなければ、三日後に再び止まる。今夜まず油を差せば、市の終わりまでは持つ。根本的に解決するなら、防湿カバーを交換する必要がある。

町長はそこで初めて理解した。記録の歯車は好奇心を満たすためではなく、システムに問題が起きたとき、最後に沈黙したという結果だけで終わらせないためなのだと。過程が見えてこそ、原因を分析し、被害の拡大を止め、復旧し、改善することができる。その後も銀鐘鎮の大時計は壊れたが、「時計が止まった」を完全な答えとする人はもういなかった。本当に価値のある問いはこうなった。どの段階が先に遅くなったのか。どの部品の影響が最も大きいのか。次は事前に見えるようにできるのか。

明らかにする

この物語が語るのは:可観測性

可観測性とは、ログ、メトリクス、トレース、イベントを通じてシステムの内部状態を理解する能力である。Agent システムにとって、可観測性はタスクの成功または失敗を知るだけではなく、モデル呼び出し、検索、ツール呼び出し、パラメータ、遅延、エラー、コスト、中間出力を振り返れることである。これによりチームは問題を特定し、行動を説明し、性能を最適化し、事故発生時に迅速に復旧できる。

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

メタファーのマッピング

  • 広場の大時計:本番環境で稼働中の Agent または AI アプリケーション
  • 鐘が鳴るか鳴らないか:ユーザーが最終的に見る成功または失敗の結果
  • 針が止まったことしか分からない:結果監視だけで、プロセスの可視性がない
  • 老師匠が経験で時計を直す:個人の経験に依存した障害対応で、規模化して再現できない
  • 歯車の刻痕:ログ、重要な動作と状態変化を記録する
  • 細い銅線:指標。遅延、スループット、エラー率、コストなどの傾向を表示する
  • 油皿の印:追跡とイベント。どの段階で先に異常が現れたかを特定する助けになる
  • 第三層の小さな軸受が渋くなる:問題の根本原因は最終出力ではなく、ごく小さな中間工程にあるかもしれない
  • 三日後に止まると事前に判断する:可観測性が予警、容量計画、継続的最適化を支える

Andy(任旭)判断

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

LogsmetricsトレースOpenTelemetryダッシュボードアラートSLO

関連する識別

この概念は隣接概念と混用されやすいので、対比ページを続けて見ることをおすすめする。

京ICP备2026014272号