SH

Soloharness

概念 · 故事 · Agent

← 返回概念解读

Concept Fable精修版

可观测性

Observability · Operations / reliability

先读故事。这里不急着给定义,先让问题自己长出来。

寓言故事

只看见钟停了,却不知道哪枚齿轮先卡住

银钟镇的广场上有一座大钟。它每天清晨报时,商铺开门,学校上课,码头放船,全镇都跟着钟声安排节奏。镇民并不懂钟,只知道钟响,就说明一切正常。

有天早晨,大钟没有响。镇长立刻叫来修钟匠。修钟匠爬上钟楼,看见指针停在五点四十七分。镇长问:哪里坏了?修钟匠说:我现在只知道它停了,不知道为什么停。

镇长很不满意。他说,钟停了不是明摆着吗?你把它修好就行。修钟匠摇头:如果只是重拨指针,它可能下午又停;如果随便换齿轮,也许换掉的是好零件。我们看到的是结果,不是原因。

过去,银钟镇修钟靠经验。听声音、摸温度、猜磨损。老师傅在时,大多能修好;老师傅病了,新人就只能拆一块、试一块、再装回去。每次修钟都像在黑箱里摸索。

后来,新修钟匠给大钟加了三样东西。第一样是小刻痕,每个齿轮转过一圈都会留下记录;第二样是细铜线,能显示哪段传动变慢;第三样是油盏标记,能看出哪里摩擦突然增加。

镇民一开始觉得这些东西多余。他们只关心钟响不响,谁会关心齿轮转了几圈?直到下一次大钟又慢了半刻。修钟匠没有拆整座钟,只看记录就发现:不是主齿轮坏了,而是第三层一个小轴承在雨后变涩,导致后面全部变慢。

这一次,修钟只用了半个时辰。更重要的是,修钟匠还能告诉镇长:如果不换这个轴承,三天后会再次停摆;如果今晚先加油,能撑到集市结束;如果要彻底解决,需要换防潮罩。

镇长这才明白,记录齿轮不是为了满足好奇心,而是为了在系统出问题时,不再只看见最后一声沉默。能看见过程,才谈得上诊断、止血、恢复和改进。

后来银钟镇的大钟仍然会坏,但再也没有人把‘钟停了’当作完整答案。真正有价值的问题变成了:哪一步先变慢?哪个部件影响最大?下一次能不能提前看见?

揭示

这个故事讲的是:可观测性

可观测性是通过日志、指标、追踪和事件来理解系统内部状态的能力。对 Agent 系统来说,可观测性不只是知道任务成功或失败,而是能回看模型调用、检索、工具调用、参数、延迟、错误、成本和中间输出。它让团队能定位问题、解释行为、优化性能,并在事故发生时快速恢复。

它重要的地方在于:它不只是一个术语,而是在真实 AI / Agent 系统里会反复出现的结构性问题。理解它,才能判断什么时候该加模型,什么时候该改流程,什么时候该补治理。

隐喻映射

  • 广场大钟:一个正在生产环境运行的 Agent 或 AI 应用
  • 钟响或不响:用户最终看到的成功或失败结果
  • 只知道指针停了:只有结果监控,没有过程可见性
  • 老师傅靠经验修钟:依赖个人经验排障,无法规模化复制
  • 齿轮刻痕:日志,记录关键动作和状态变化
  • 细铜线:指标,显示延迟、吞吐、错误率、成本等趋势
  • 油盏标记:追踪与事件,帮助定位哪一步先出现异常
  • 第三层小轴承变涩:问题根因可能在很小的中间环节,而不是最终输出
  • 提前判断三天后会停:可观测性支持预警、容量规划和持续优化

Soloharness 判断

这个概念的实战价值,是帮你把“看起来聪明的 AI 功能”拆成可交付、可验收、可治理的工作单元。

LogsmetricstracesOpenTelemetrydashboardsalertsSLO