jaegertracing /jaeger
CNCF Jaeger, a Distributed Tracing Platform
★ 23,415⑂ 3,248👁 311⑃ 6,812● 2,722▤ 111
+6
Daily
+49
Weekly
+131
Monthly
23,415
stars
3,248
forks
311
watchers
6,812
prs
2,722
issues
111
releases
README
[![Slack chat][slack-img]](get-in-touch)
[![Unit Tests][ci-img]][ci]
[![Coverage Status][cov-img]][cov]
[![Project+Community stats][community-badge]][community-stats]
[![FOSSA Status][fossa-img]][fossa]
[![OpenSSF Scorecard][openssf-img]][openssf]
[![OpenSSF Best Practices][openssf-bp-img]][openssf-bp]
[![CLOMonitor][clomonitor-img]][clomonitor]
[![Artifact Hub][artifacthub-img]][artifacthub]
Jaeger - a Distributed Tracing System
💥💥💥 Jaeger v2 is out! Read the blog post and try it out.
Quick Start
Get Jaeger running in seconds with Docker:
bash
Run Jaeger all-in-one (includes UI, collector, query, and in-memory storage)
docker run --rm --name jaeger \
-p 16686:16686 \
-p 4317:4317 \
-p 4318:4318 \
jaegertracing/jaeger:latest
Access the UI at http://localhost:16686
Send traces via OTLP: gRPC on port 4317, HTTP on port 4318
For production deployments and more options, see the Getting Started Guide.
Architecture
mermaid
graph TD
SDK["OpenTelemetry SDK"] -- |HTTP or gRPC| COLLECTOR
COLLECTOR["Jaeger Collector"] -- STORE[Storage]
COLLECTOR -- |gRPC| PLUGIN[Storage Plugin]
COLLECTOR -- |gRPC/sampling| SDK
PLUGIN -- STORE
QUERY[Jaeger Query Service] -- STORE
QUERY -- |gRPC| PLUGIN
UI[Jaeger UI] -- |HTTP| QUERY
subgraph Application Host
subgraph User Application
SDK
end
end
Jaeger is a distributed tracing platform created by Uber Technologies and donated to Cloud Native Computing Foundation.
See Jaeger [documentation][doc] for getting started, operational details, and other information.
Jaeger is hosted by the Cloud Native Computing Foundation (CNCF) as the 7th top-level project, graduated in October 2019. See the CNCF Jaeger incubation announcement and Jaeger graduation announcement.
Get Involved
Jaeger is an open source project with open governance. We welcome contributions from the community, and we would love your help to improve and extend the project. Here are some ideas for how to get involved. Many of them do not even require any coding.
Version Compatibility Guarantees
Since Jaeger uses many components from the OpenTelemetry Collector we try to maintain configuration compatibility between Jaeger releases. Occasionally, configuration options in Jaeger (or in Jaeger v1 CLI flags) can be deprecated due to usability improvements, new functionality, or changes in our dependencies.
In such situations, developers introducing the deprecation are required to follow these guidelines.
In short, for a deprecated configuration option, you should expect to see the following message in the documentation or release notes:
(deprecated, will be removed after yyyy-mm-dd or in release vX.Y.Z, whichever is later)
A grace period of at least 3 months or two minor version bumps (whichever is later) from the first release
containing the deprecation notice will be provided before the deprecated configuration option _can_ be deleted.
For example, consider a scenariTop issues
#4708[Feature]: Support Elasticsearch/OpenSearch data stream62 comments · 2023-08-29#638💾 Additional storage backends59 comments · 2018-01-08#5717Create e2e integration tests for Adaptive Sampling56 comments · 2024-07-08#9135[Feature/🧑🎓 LFX] Evaluating and Optimizing the Jaeger AI Assistant: MCP Tools + Skills44 comments · 2026-07-29#207SURVEY: Who is using Jaeger42 comments · 2017-06-14#1051Jaeger Query can OOM when retrieving large traces38 comments · 2018-09-05#8691[chore]: Add backward compatibility integration tests for backends37 comments · 2026-06-02#7827[Feature]: GenAI integration with Jaeger35 comments · 2026-01-02
Discussions
#9973Remediate missing Content-Security-Policy (CSP) frame-ancestors directive on Jaeger web interface0 comments · 2026-10-30#9818Question about the Jaeger service address1 comments · 2026-10-10#9625Configuration for multi tenancy in Jaeger V22 comments · 2026-09-23#9512Query about jaeger v2.21.0 release2 comments · 2026-09-07#9368Pagination Issue - api/v3/traces endpoint1 comments · 2026-08-18#9228acorn 8.17.0 introduces AGPL license in dependency tree1 comments · 2026-08-05#9153Jaeger v2 ILM1 comments · 2026-07-30#9034Safe production upgrade from Jaeger Operator 1.62.0 to 1.65.01 comments · 2026-07-18
Latest release
Release v2.23.0 v2.23.0 2026-11-05Backend Changes ⛔ Breaking Changes Fix(storage): remove unused clickhouse feature gates (@albertteoh in 9988) Fix(storage): resolve auth extension references deterministically (@jkowall in 9772) Chore(ai-sidecar): remove the gemini reference sidecar (@alishair7071 in 9841) Feat(clickhouse): require an explicit table engine when creating the schema (@ysh-bot in 9813) ✨ New Features Feat(mcp): accept a sql statement in the search_traces tool (@ysh-bot in 9925) Feat(query): add a sql query surface that compiles to rfc 0005 filters (@ysh-bot in 9922) Feat(query): serve storage search