The main Jaeger backend components are released as Docker images on Docker Hub  and Quay :

!!!UPDATE THE TABLE BELOW

The images listed above are the primary release versions. Most components have additional images published:

• ${component}-debug images include Delve debugger
• ${component}-snapshot images are published from the tip of the main branch for every commit, allowing testing of unreleased versions
• ${component}-debug-snapshot snapshot images that include the Delve debugger

There are orchestration templates for running Jaeger with:

• Kubernetes: github.com/jaegertracing/jaeger-kubernetes ,
• OpenShift: github.com/jaegertracing/jaeger-openshift .

Configuration Options

jaeger binaries are configured via configuration YAML file. The following ports are exposed by default:

jaeger is stateless and thus many instances of jaeger can be run in parallel. jaeger instances require almost no configuration, except for storage location, such as:

Cassandra:

  jaeger_storage:
    backends:
      some_storage:
        cassandra:
          schema: 
            keyspace: "jaeger_v1_dc1"
          connection:
            auth: 
              basic:
                username: "cassandra"
                password: "cassandra"
            tls:
              insecure: true

OpenSearch:

  jaeger_storage:
    backends:
      some_storage:
        opensearch:
          index_prefix: "jaeger-main"

ElasticSearch:

  jaeger_storage:
    backends:
      some_storage:
        elasticsearch:
          index_prefix: "jaeger-main"
      another_storage:
        elasticsearch:
          index_prefix: "jaeger-archive"

The following ports can also be used by jaeger for various types of integrations:

Clock Skew Adjustment

Jaeger backend combines trace data from applications that are usually running on different hosts. The hardware clocks on the hosts often experience relative drift, known as the clock skew effect . Clock skew can make it difficult to reason about traces, for example, when a server span may appear to start earlier than the client span, which should not be possible. jaeger query extension implements a clock skew adjustment algorithm (code ) to correct for clock drift, using the knowledge about causal relationships between spans. All adjusted spans have a warning displayed in the UI that provides the exact clock skew delta applied to their timestamps.

Sometimes these adjustments themselves make the trace hard to understand. For example, when repositioning the server span within the bounds of its parent span, Jaeger does not know the exact relationship between the request and response latencies, so it assumes they are equal and places the child span in the middle of the parent span (see issue #961 ).

jaeger query extension supports configuration in the config file

query:
  max-clock-skew-adjustment: 30s

that controls how much clock skew adjustment should be allowed. Setting this parameter to zero (0s) disables clock skew adjustment completely. This setting applies to all traces retrieved from the given query service. There is an open ticket #197  to support toggling the adjustment on and off directly in the UI.

UI Base Path

The base path for all jaeger query extension HTTP routes can be set to a non-root value, e.g. /jaeger would cause all UI URLs to start with /jaeger. This can be useful when running jaeger behind a reverse proxy. Here is example code to set the base path.

query:
  base-path: /
  static-files: /go/bin/jaeger-ui-build/build
  ui-config: /etc/jaeger/ui-config.json
  grpc-server:
    host-port: 0.0.0.0:16685
  http-server:
    host-port: 0.0.0.0:16686

UI Customization and Embedding

Please refer to the dedicated Frontend/UI page.

Aggregation Jobs for Service Dependencies

Production deployments need an external process that aggregates data and creates dependency links between services. Project spark-dependencies  is a Spark job which derives dependency links and writes them directly to the storage.