Skip to content

docs: replace deprecated Jaeger tracing with SigNoz/OTLP setup - #60

Merged
haixuanTao merged 2 commits into
dora-rs:mainfrom
DEFAULTE-R:docs/update-tracing-guide-signoz
Mar 26, 2026
Merged

docs: replace deprecated Jaeger tracing with SigNoz/OTLP setup#60
haixuanTao merged 2 commits into
dora-rs:mainfrom
DEFAULTE-R:docs/update-tracing-guide-signoz

Conversation

@DEFAULTE-R

Copy link
Copy Markdown

Fixes #1313 (reported in dora-rs/dora)

The previous tracing guide referenced DORA_JAEGER_TRACING which has been fully removed from the dora codebase (see dora-rs/dora#1397). This PR updates the documentation to reflect the current recommended setup using SigNoz and OTLP.

Changes:

  • Removed deprecated Jaeger instructions
  • Added SigNoz setup steps (validated locally)
  • Updated environment variable to DORA_OTLP_ENDPOINT
  • Added notes clarifying deprecation status

Tested on: Ubuntu 24.04 (WSL2), dora-cli 0.4.1, SigNoz v0.115.0

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the tracing documentation to reflect Dora’s current OpenTelemetry (OTLP) tracing support and replaces the removed Jaeger-based workflow with a SigNoz-based setup.

Changes:

  • Replace deprecated DORA_JAEGER_TRACING instructions with an OTLP-based tracing flow.
  • Add a step-by-step SigNoz Docker Compose setup and viewing instructions.
  • Update the documented environment variable to DORA_OTLP_ENDPOINT and add deprecation notes.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

# Tracing

You can easily integrate jaeger tracing by providing `DORA_JAEGER_TRACING` environment variable
Dora supports distributed tracing via OpenTelemetry (OTLP). The previous Jaeger integration (DORA_JAEGER_TRACING) has been removed as of recent versions. Use the OTLP endpoint instead.

## Setup with SigNoz

[SigNoz](https://signoz.io) is the recommended open-source observability backend for dora tracing.
Comment thread docs/guides/Debugging/tracing.md Outdated
```bash
docker run -d -p6831:6831/udp -p6832:6832/udp -p16686:16686 jaegertracing/all-in-one:latest
export DORA_OTLP_ENDPOINT=http://localhost:4317
dora run dataflow.yaml --uv

- DORA_JAEGER_TRACING is no longer supported and has been removed from the codebase.
- The OTLP collector in SigNoz listens on port 4317 by default.
- Metrics ingestion is active when the endpoint is correctly configured.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@phil-opp
phil-opp requested a review from haixuanTao March 18, 2026 12:17
@haixuanTao
haixuanTao merged commit e2ee8f9 into dora-rs:main Mar 26, 2026
2 checks passed
@haixuanTao

Copy link
Copy Markdown
Contributor

thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants