dsh-o11y-plugin
为 deepseek-harness 插件提供统一的可观测性（追踪/日志/指标）：在可用时接入 dsh 会话遥测，在不可用时维护 OTel 信号，并通过标准 OTLP 导出。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:fly3366/dsh-o11y-plugin#542ce59c442d2a0c8117d4d874522fc50a845a54O11y Plugin 以 dsh-o11y-plugin 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →Unified plugin-dimension observability (trace / log / metric) for deepseek-harness (dsh).
dsh ships session-level OTel telemetry but exposes no metric or plugin-scoped
observability to plugins. dsh-o11y-plugin converges that gap: it registers
global OpenTelemetry providers so any plugin using the standard
@opentelemetry/api exports traces, metrics, and logs through a single,
consistently configured pipeline, and it bridges dsh session telemetry into
OTel logs. It is intended for plugin authors who want standard,
community-compatible observability without implementing OTel per plugin.
| Item | Value |
|---|---|
| DSH compatibility | @deepseek-ai/dsh 0.1.0-rc.6–rc.8 (optional bridge hook unchanged; no dsh service deps) |
| Runtime dependency | @deepseek-ai/cordis 4.0.1 only |
| Last verified | 2026-08-20 (unit tests against @deepseek-ai/cordis 4.0.1) |
| Node | ^22.19 || >=24 |
| Profiles | headless, web |
Built on the official OpenTelemetry Node.js SDK, the same dependency family as
dsh's session-telemetry-otel.
# install
dsh plugin --profile web add github:fly3366/dsh-o11y-plugin
# disable for one profile
dsh plugin --profile web remove dsh-o11y-plugin
# or disable at runtime via config: enabled=false
The plugin is stateless; removal requires no data cleanup.
dsh plugin --profile headless add github:fly3366/dsh-o11y-plugin
# point exports at a collector (optional; silent without one)
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 dsh --profile headless "say hi"
Any plugin that calls trace.getTracer(...) / metrics.getMeter(...) /
logs.getLogger(...) from @opentelemetry/api is then exported automatically.
deepjit is the reference consumer,
emitting pipeline counters and GenAI (gen_ai.*) LLM spans.
| Key | Default | Description |
|---|---|---|
enabled | true | master switch |
serviceName | '' (→ OTEL_SERVICE_NAME → dsh-plugin) | OTel resource service.name |
endpoint | '' (→ OTEL_EXPORTER_OTLP_ENDPOINT → http://localhost:4318) | OTLP/HTTP endpoint |
enableTraces / enableMetrics / enableLogs | true | per-signal toggles |
metricExportIntervalMs | 60000 | periodic metric export interval |
bridgeSessionTelemetry | true | bridge dsh session telemetry into OTel logs |
Sensitive: no credentials are read or stored; only the optional OTLP endpoint is network-facing.
endpoint and collector
availability.dsh plugin --profile <p> remove dsh-o11y-plugin or set
enabled=false.npm install
npm run typecheck
npm test
npm run build
Contributions welcome; keep the OTel SDK dependency family aligned with dsh's
session-telemetry-otel for community compatibility.
MIT. Report vulnerabilities privately per SECURITY.md.