Skip to content
  • Home
  • Plugin manual
  • dsh-plugin

loongsuite/dsh-plugin

31Last commit Aug 16, 2026

dsh-plugin DSH plugin

@loongsuite/dsh-plugin is a standalone, open-source observability plugin for DeepSeek Harness (DSH). It observes DSH's native session, agent loop, LLM stream, and tool lifecycle, converts them into OpenTelemetry GenAI traces and metrics, and exports standard OTLP/HTTP protobuf to any compatible backend. The plugin does not depend on any vendor-specific sidecar or backend.

developer-tools

How to install the dsh-plugin DSH plugin

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

Copying does not run this command. Review the repository and version before installing the dsh-plugin DSH plugin.

dsh-plugin DSH plugin data source

dsh-plugin DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-plugin DSH plugin can do

  • Converts DSH sessions, agent loops, LLM streams, and tool calls into OpenTelemetry GenAI traces and metrics.
  • Exports traces and metrics via OTLP/HTTP protobuf to any OpenTelemetry-compatible backend.
  • Supports configuration via environment variables or plugin settings in the DSH profile YAML.
  • Content capture (prompts, responses, tool schemas) is disabled by default for privacy; can be enabled explicitly.
  • Compatible with DSH >=0.1.0-rc.6 and <0.2.0, and Node.js >=22.19.0.

Where the dsh-plugin DSH plugin fits

  • Monitor per-call latency and token usage of your DSH agent in a dashboard like Grafana or Jaeger.
  • Debug multi-step agent workflows by examining detailed traces for each turn, tool call, and LLM retry.
  • Collect LLM performance metrics (duration, token counts) to optimize model usage and costs.
  • Integrate DSH observability into existing OpenTelemetry pipelines without adding a proprietary backend.

Who the dsh-plugin DSH plugin is for

  • Developers building and deploying agents with DeepSeek Harness who need observability.
  • AI engineering teams that want to monitor DSH agent behavior in production using OpenTelemetry-compatible tools.

dsh-plugin DSH plugin limitations

  • Beta release; not yet stable for production use.
  • Only supports DSH version range >=0.1.0-rc.6 and <0.2.0.
  • Requires Node.js 22.19 or newer.
  • Content capture can expose sensitive data (source code, credentials, personal data); must be used with caution and proper backend access controls.

dsh-plugin DSH plugin: from the repository README

Quoted from the loongsuite/dsh-plugin README, the upstream source of the dsh-plugin DSH plugin. Copyright remains with the original authors.

English | [简体中文](README.zh-CN.md) `@loongsuite/dsh-plugin` is a standalone, open-source observability plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`). It observes DSH's native session, agent loop, LLM stream, and tool lifecycle, converts them into OpenTelemetry GenAI traces and metrics, and exports standard OTLP/HTTP protobuf to any compatible backend. LoongSuite is an open-source observability collection ecosystem built on OpenTelemetry. This repository is its native DSH integration. The plugin does **not** depend on or require LoongSuite Pilot, a sidecar, a local JSONL tap, or any particular vendor's backend. > Status: beta release. Install the npm beta with `@loongsuite/dsh-plugin@beta`. The plugin is > listed in the community registry, so it can also be installed from the DSH plugin market. <p align="center"> <img src="docs/assets/langfuse-trace.png" alt="One DeepSeek Harness turn as an OpenTelemetry GenAI trace, viewed in self-hosted Langfuse" width="900"> <br> <em>One DSH turn exported over OTLP into self-hosted Langfuse: four react steps, per-call latency and token counts, a failed <code>web_search</code> followed by <code>b

Read the full READMERepository license: Apache-2.0

dsh-plugin DSH plugin questions

How do I install @loongsuite/dsh-plugin?

During the beta, use the beta tag: `dsh plugin --profile <profile> add @loongsuite/dsh-plugin@beta`. Replace `<profile>` with the profile name (e.g., web or headless). You can also install it from the DSH plugin market if listed.

What backends does the plugin support?

The plugin exports OTLP/HTTP protobuf, so it works with any OpenTelemetry-compatible backend, such as Jaeger, Langfuse, Grafana Tempo, or any collector that accepts OTLP. The example quickstart uses a local Collector and Jaeger.

How do I enable content capture?

Set the environment variable `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=SPAN_ONLY` before starting DSH, or set `captureContent: true` in the plugin configuration. Be aware this may expose sensitive data; review backend security first.

Can I use the plugin without a DSH profile?

No, the plugin is installed per DSH profile using the `dsh plugin` command. You must add it to at least one profile (e.g., web or headless) to enable observability for that profile.

What versions of Node.js and DSH are compatible?

Node.js 22.19 or newer is required. DSH versions >=0.1.0-rc.6 and <0.2.0 are supported. Older DSH release candidates are not supported.