什么是 agent 可观测性——以及为什么你的日志还没有它

2026-10-17 — “可观测性”今年被借用得很厉害。但市面上大多数以此命名的产品，回答的仍是上一个十年的问题：多少 token、多少延迟、模型返回了什么。那是 LLM 可观测性——它讲的是对话，不是 agent 随后对你的文件、进程、凭证和网络做了什么。Agent 可观测性问的是另一个问题：哪个动作、由哪个 agent、对着哪个资源、当时按策略怎么判、发生在几点——明天我还拿得出来证明吗？

一份真实记录必须回答的三个问题

• 归属：agent 以进程树运行。只写“模型”二字的记录，说不出是哪个家族、哪个会话、哪个被派生的子进程碰了资源。归属链必须写在行内。
• 动作形状，而非载荷：重要的是某条命令瞄准了敏感资源这个形状，而不是流经的私密字节。把载荷一并收集，是“可观测性”自己变成泄密源的方式。
• 动作发生那一刻的判定：只列事件的日志没有立场。把动作当时生效的策略评估附着在记录上，转录才成为证据。

为什么日常日志在这里失效

终端滚屏随窗口关闭而消失。shell 历史不做归属——agent 执行的命令和你手敲的一模一样。agent 侧的转录描述的是意图，不是效果：它记“想做什么”，不记操作系统实际放行了什么。而供应商账单面板活在另一个平面：它按请求计费，从来看不到文件系统。问题不是没人记录任何东西，而是事故发生后你真正要问的那句话，现在记下的东西没有一条能采信。

我们记录什么，拒绝记录什么

20131 在你的 agent 与机器之间本地运行，每个被观测的动作写一条仅追加的本地记录：agent 家族、进程归属链、命令形状、时间戳，以及动作当时附着的策略判定。密钥从不落盘——每个来自操作系统的字符串先过脱敏层。畸形事件在写入前即被拒绝，零字节落盘，因此文件的可信不依赖“上报者诚实”的承诺。采集器零外呼：记录留在你的磁盘上。今天这是 Phase 0——观察、评估、审计。高风险动作以 would_block 判定记录在案，然后照常放行。阻断属于后续阶段、有它自己的公告；这一页同样不抢代码的进度。

如果你要的是“可证”的版本

记录凭什么可证，另有一篇长文：<a href="/zh-cn/blog/agent-behavior-provable/">把 agent 行为做成事后可证</a>。逐行写入的机制在<a href="/zh-cn/docs/">文档</a>，从动作到判定的流程在<a href="/zh-cn/how-it-works/">工作原理</a>。如果你在用 coding agent，而手头任何工具都回答不了“你能证明它做了什么吗”，<a href="/zh-cn/early-access/">抢先体验名单</a>是这件事最先出现的地方——体验期所有方案免费，正式定价上线时公布。