dsh-plugin 使用指南

DSH 独立可观测插件，把 Agent 对话、LLM 调用与工具执行转为 OpenTelemetry GenAI trace 与 metric，通过标准 OTLP/HTTP protobuf 上报到任意兼容后端。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add @loongsuite/dsh-plugin

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

— 源: plugin_wiki.readme_zh (fallback readme_raw)

安装后还需要额外配置吗？

不需要。装上即用，未配置 OTLP endpoint 时使用 OpenTelemetry 默认地址；不配置 OTLP_SERVICE_NAME 时上报名默认为 deepseek-harness。

需要额外安装 LoongSuite Pilot 或本地 sidecar 吗？

不需要。插件自带私有 OTLP pipeline，直接把数据发到任意兼容后端，不依赖 Pilot、不读取本地 JSONL 日志。

默认会采集提示词、回复和工具参数吗？

不会。默认 captureContent=false，仅上报结构化元数据与 token 用量；需要采集正文时显式开启或在环境变量里设 SPAN_ONLY。

会替换 DSH 或其他库的全局 OTel Provider 吗？

不会。插件创建的是私有 TracerProvider 与 MeterProvider，不会干扰宿主或其他依赖的全局 Provider。

能不卸载就临时关掉吗？

能。把 plugin 配置的 enabled 设为 false，bundle 仍在，但不再采集任何 span 与 metric。

怎样禁用指标上报以适配只支持 trace 的后端？

设置 exportMetrics=false，或在环境变量里把 OTEL_METRICS_EXPORTER 设为 none。

HMR 重载会产生重复 trace 吗？

不会。插件只接管已存在 session 的身份，并从下一次原生 turn/start 开始采集，不会重放历史事件。

能直接对接 Langfuse 吗？

能。把 endpoint 设为 https://cloud.langfuse.com/api/public/otel，并在 headers 里加入 Authorization Basic 与 x-langfuse-ingestion-version 即可。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则