🧩

dsh-observability

admin-security 更新于 2026.08.15

在终端中运行以下命令：

dsh plugin install CodePrometheus/dsh-observability

将以下提示词粘贴到 DeepSeek Harness 对话框中：

在 DeepSeek Harness 中运行 dsh plugin install CodePrometheus/dsh-observability 即可安装本插件（源码：https://github.com/CodePrometheus/dsh-observability）。

插件介绍

官方 DeepSeek Harness 遥测 Service Definition 目前仅导出 OTLP 日志，追踪维度长期空白。dsh-observability 是一个社区插件，在同一 Service Definition 上注册第二个 Service Provider，将每段 Agent 会话折叠为 OTLP span 树并推送到任意接受 OTLP/HTTP 的 Collector（Jaeger、Grafana Tempo、Datadog 等），补上了 LLM Agent 链路追踪这一关键缺口。

映射关系清晰直观：一个 turn 对应 trace 根 span，一个 model step 是子 span 并标记 gen_ai.operation.name=chat，一次 tool call 是孙 span 并标记 execute_tool。每个 span 携带完整 GenAI 语义属性——模型名、provider、五项 token 用量计数器（input、output、cache read、cache write、reasoning）、首 chunk 延迟、错误码与状态。三种模式（FULL、FEEDBACK_ONLY、DISABLED）控制数据出口，默认 DISABLED 不构造任何对象。trace/span ID 由 session.id、turn、step 派生而非随机生成，因此实时采集与 FEEDBACK_ONLY 回放同一事件集会产生字节级相同的树，重复投递在接收端幂等。缺少终态事件的 span 会被 force-end sweep 关闭并标记 dsh.force_ended。插件纯粹只读：既不组装也不发送任何 provider 请求，对 KV Cache 无影响。

适合已经在用 OTLP Collector 的团队将 dsh Agent 会话纳入现有 APM 或合规管线；需要按 turn 做 token 成本归因与 TTFB 分析的开发者；以及希望在社区层面扩展 dsh 可观测性栈的贡献者。需要注意的是：插件不内置脱敏规则，超出信任边界的导出部署必须自行挂载 waterfall 规则；同一上下文中只允许一个遥测后端，若需同时运行官方 logs provider 与本插件，需等待上游多 sink 演进。