dsh-prometheus

English | 中文

面向 DeepSeek Harness 的 Prometheus 指标插件与可直接导入的 Grafana Dashboard。插件只观察 DSH 的公开生命周期扩展点，在导出前限制指标序列基数，并避免输出对话或工具载荷。

发布状态：0.1.0 是首个 Developer Preview 版本，已针对 DSH 0.1.0-rc.6 完成测试。

监控范围

• 活跃 Session；Agent turn、step、error 及耗时直方图
• LLM 请求速率、终止状态、延迟，以及互不重叠的输入/输出/推理/缓存 token 计数
• Tool 调用速率、规范化成功/失败状态及延迟
• Approval 请求和固定结果计数
• Subagent 启动、结果及耗时
• 后台 job 的活跃/启动/完成/终止/失败数量及耗时
• 进程启动时间和标签溢出诊断

完整指标名、标签和语义见 docs/metrics.md。

兼容性

组件	已测试版本
DeepSeek Harness npm packages	0.1.0-rc.6
官方源码基线	47f943859bef60e4160492346772ded9b24f765a（2026-08-13）
Cordis	^4.0.1
Node.js	`^22.19.0
prom-client	15.1.3

DeepSeek Harness 当前仍是 Developer Preview。每次升级 DSH 都应视为一次兼容性变更，并执行完整测试与发布清单。

安装

将 npm package 安装到 DSH profile，并检查 bundle layer：

dsh plugin --profile monitoring add dsh-prometheus
dsh --profile monitoring --dump-config

Bundle 会插入 id 为 prometheus 的一行。启动 profile 前，请确认 dump 中出现 dsh-prometheus layer。

Endpoint 选择

默认 mode: auto 会在插件激活时做一次选择：

1. 如果公开的 DSH webServer 已激活且绑定安全，则注册精确的 /metrics 路由；
2. 否则在 127.0.0.1:9464 启动独立 endpoint。

仓库内的 Docker 示例需要固定 target，建议在 profile 的 cordis.patch.yml 中强制 standalone。后应用的 patch 会替换整段 config：

- id: prometheus
  config:
    enabled: true
    mode: standalone
    host: 127.0.0.1
    port: 9464
    path: /metrics
    allowRemote: false
    maxLabelValues: 64
    maxLabelValueLength: 80

配置项

字段	默认值