@deepseek-ai/dsh-trace

Configuration reference

Field	Required or default	Purpose
database.dataDir	Required	Local yiTrace directory. Relative paths resolve from the process working directory at plugin load; use an absolute path for service deployments.
database.tenantId	Optional	Unsigned 64-bit tenant scope attached to writes. Use the same value when querying.
database.maxBuffered	batchSize × 16	Maximum events retained in memory after embedded ingest failures; the oldest events are dropped after the limit.
batchSize	256	Events collected before one serialized embedded ingest.
nodeId	Derived by yiTrace	Snowflake node id in 0..1023. Parallel writers must not share an explicit value.
agentName	Harness product identity	Agent name attached to every span.
shutdownTimeoutMillis	3000	Maximum time DSH awaits shutdown. The deadline cannot cancel a native database call already in progress.

An empty data directory, invalid unsigned 64-bit tenant id, invalid node id, or non-positive size/deadline fails at plugin load.

The telemetry seam admits one backend per Cordis context. Loading this package together with session-telemetry-otel fails as a duplicate service instead of recording twice. A host-level privacy switch must disable every configured telemetry row; the plugin does not bypass that host policy.