Jaeger

To enable the Jaeger:

  1. [tracing]
  2.   [tracing.jaeger]
  1. tracing:
  2.   jaeger: {}
  1. --tracing.jaeger=true

Warning

Traefik is able to send data over the compact thrift protocol to the Jaeger agent or a Jaeger collector.

samplingServerURL

Required, Default="http://localhost:5778/sampling"

Sampling Server URL is the address of jaeger-agent's HTTP sampling server.

  1. [tracing]
  2.   [tracing.jaeger]
  3.     samplingServerURL = "http://localhost:5778/sampling"
  1. tracing:
  2.   jaeger:
  3.     samplingServerURL: http://localhost:5778/sampling
  1. --tracing.jaeger.samplingServerURL=http://localhost:5778/sampling

samplingType

Required, Default="const"

Sampling Type specifies the type of the sampler: const, probabilistic, rateLimiting.

  1. [tracing]
  2.   [tracing.jaeger]
  3.     samplingType = "const"
  1. tracing:
  2.   jaeger:
  3.     samplingType: const
  1. --tracing.jaeger.samplingType=const

samplingParam

Required, Default=1.0

Sampling Param is a value passed to the sampler.

Valid values for Param field are:

  • for const sampler, 0 or 1 for always false/true respectively
  • for probabilistic sampler, a probability between 0 and 1
  • for rateLimiting sampler, the number of spans per second 
  1. [tracing]
  2.   [tracing.jaeger]
  3.     samplingParam = 1.0
  1. tracing:
  2.   jaeger:
  3.     samplingParam: 1.0
  1. --tracing.jaeger.samplingParam=1.0

localAgentHostPort

Required, Default="127.0.0.1:6831"

Local Agent Host Port instructs reporter to send spans to jaeger-agent at this address.

  1. [tracing]
  2.   [tracing.jaeger]
  3.     localAgentHostPort = "127.0.0.1:6831"
  1. tracing:
  2.   jaeger:
  3.     localAgentHostPort: 127.0.0.1:6831
  1. --tracing.jaeger.localAgentHostPort=127.0.0.1:6831

gen128Bit

Optional, Default=false

Generate 128-bit trace IDs, compatible with OpenCensus.

  1. [tracing]
  2.   [tracing.jaeger]
  3.     gen128Bit = true
  1. tracing:
  2.   jaeger:
  3.     gen128Bit: true
  1. --tracing.jaeger.gen128Bit

propagation

Required, Default="jaeger"

Set the propagation header type. This can be either:

  • jaeger, jaeger's default trace header.
  • b3, compatible with OpenZipkin 
  1. [tracing]
  2.   [tracing.jaeger]
  3.     propagation = "jaeger"
  1. tracing:
  2.   jaeger:
  3.     propagation: jaeger
  1. --tracing.jaeger.propagation=jaeger

traceContextHeaderName

Required, Default="uber-trace-id"

Trace Context Header Name is the http header name used to propagate tracing context. This must be in lower-case to avoid mismatches when decoding incoming headers.

  1. [tracing]
  2.   [tracing.jaeger]
  3.     traceContextHeaderName = "uber-trace-id"
  1. tracing:
  2.   jaeger:
  3.     traceContextHeaderName: uber-trace-id
  1. --tracing.jaeger.traceContextHeaderName=uber-trace-id

collector

endpoint

Optional, Default=""

Collector Endpoint instructs reporter to send spans to jaeger-collector at this URL.

  1. [tracing]
  2.   [tracing.jaeger.collector]
  3.     endpoint = "http://127.0.0.1:14268/api/traces?format=jaeger.thrift"
  1. tracing:
  2.   jaeger:
  3.     collector:
  4.         endpoint: http://127.0.0.1:14268/api/traces?format=jaeger.thrift
  1. --tracing.jaeger.collector.endpoint=http://127.0.0.1:14268/api/traces?format=jaeger.thrift

user

Optional, Default=""

User instructs reporter to include a user for basic http authentication when sending spans to jaeger-collector.

  1. [tracing]
  2.   [tracing.jaeger.collector]
  3.     user = "my-user"
  1. tracing:
  2.   jaeger:
  3.     collector:
  4.         user: my-user
  1. --tracing.jaeger.collector.user=my-user

password

Optional, Default=""

Password instructs reporter to include a password for basic http authentication when sending spans to jaeger-collector.

  1. [tracing]
  2.   [tracing.jaeger.collector]
  3.     password = "my-password"
  1. tracing:
  2.   jaeger:
  3.     collector:
  4.         password: my-password
  1. --tracing.jaeger.collector.password=my-password