How jaegertracing/jaeger works
Jaeger is a distributed tracing platform. The main documented workflow sends application traces to the collector, stores them, and exposes trace search through the query service and UI; sampling strategies can also flow back to applications. The repository additionally contains remote-storage serving, AI/MCP query tools, storage backends, and a Python query SDK. Edges use README statements or source-index references; unsampled implementation details are not inferred beyond those references.
Main entry points: internal/server.go Query handlers · interface.go Trace storage · components.go Collector · jaegerquery/server.go Query service
Components 16
Trace ingestion
- Collector
cmd/jaeger/internal/components.go
Query and exploration
- Query service
cmd/jaeger/internal/extension/jaegerquery/server.go - Query handlers
cmd/jaeger/internal/extension/jaegerquery/internal/server.go - Trace query parser
cmd/jaeger/internal/extension/jaegerquery/internal/apiv3/query_parser.go - Query service logic
cmd/jaeger/internal/extension/jaegerquery/querysvc/service.go - AI and MCP tools
cmd/jaeger/internal/extension/jaegerquery/internal/jaegerai/routes.go - Jaeger UI
cmd/jaeger/internal/extension/jaegerquery/internal/ui/assets.go
Storage
- Trace storage
internal/storage/v1/api/spanstore/interface.go - Remote storage server
cmd/remote-storage/app/server.go - Cassandra sampling store
internal/storage/v1/cassandra/samplingstore/storage.go
Sampling
- Remote sampling
cmd/jaeger/internal/extension/remotesampling/extension.go - Adaptive sampling
cmd/jaeger/internal/processors/adaptivesampling/processor.go
Operations and SDK
- Python query builder
sdk/python/src/jaeger_query/query.py - Python query client
sdk/python/src/jaeger_query/client.py - Elasticsearch utilities
cmd/es-rollover/main.go
Other components
- Instrumented app
Connections 14
- Instrumented app → Collector: sends traces
README.md - Collector → Trace storage: stores traces
README.md - Collector → Remote sampling: requests sampling
README.md - Remote sampling → Instrumented app: returns strategies
README.md - Query service → Trace storage: queries traces
README.md - Jaeger UI → Query service: uses HTTP
README.md - Query handlers → Trace query parser: registers API
cmd/jaeger/internal/extension/jaegerquery/internal/server.go - Trace query parser → Query service logic: uses query logic
cmd/jaeger/internal/extension/jaegerquery/internal/apiv3/query_parser.go - Query handlers → Query service logic: uses service
cmd/jaeger/internal/extension/jaegerquery/internal/server.go - Query handlers → AI and MCP tools: registers routes
cmd/jaeger/internal/extension/jaegerquery/internal/server.go - Query service → Query handlers: configures handlers
cmd/jaeger/internal/extension/jaegerquery/server.go - Python query client → Python query builder: uses builder
sdk/python/src/jaeger_query/client.py - Remote storage server → Trace storage: serves storage API
cmd/remote-storage/app/server.go - Elasticsearch utilities → Trace storage: manages indices