traefik/docs/content/observability/tracing/jaeger.md

# Jaeger

To enable the Jaeger:

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger]
```

```yaml tab="File (YAML)"
tracing:
  jaeger: {}
```

```bash tab="CLI"
--tracing.jaeger=true
```

!!! warning
    Traefik is able to send data over the compact thrift protocol to the [Jaeger agent](https://www.jaegertracing.io/docs/deployment/#agent)
    or a [Jaeger collector](https://www.jaegertracing.io/docs/deployment/#collectors).

#### `samplingServerURL`

_Required, Default="http://localhost:5778/sampling"_

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

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger]
    samplingServerURL = "http://localhost:5778/sampling"
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    samplingServerURL: http://localhost:5778/sampling
```

```bash tab="CLI"
--tracing.jaeger.samplingServerURL=http://localhost:5778/sampling
```

#### `samplingType`

_Required, Default="const"_

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

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger]
    samplingType = "const"
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    samplingType: const
```

```bash tab="CLI"
--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

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger]
    samplingParam = 1.0
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    samplingParam: 1.0
```

```bash tab="CLI"
--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.

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger]
    localAgentHostPort = "127.0.0.1:6831"
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    localAgentHostPort: 127.0.0.1:6831
```

```bash tab="CLI"
--tracing.jaeger.localAgentHostPort=127.0.0.1:6831
```

#### `gen128Bit`

_Optional, Default=false_

Generate 128-bit trace IDs, compatible with OpenCensus.

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger]
    gen128Bit = true
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    gen128Bit: true
```

```bash tab="CLI"
--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

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger]
    propagation = "jaeger"
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    propagation: jaeger
```

```bash tab="CLI"
--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.

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger]
    traceContextHeaderName = "uber-trace-id"
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    traceContextHeaderName: uber-trace-id
```

```bash tab="CLI"
--tracing.jaeger.traceContextHeaderName=uber-trace-id
```

### disableAttemptReconnecting

_Optional, Default=true_

Disable the UDP connection helper that periodically re-resolves the agent's hostname and reconnects if there was a change.
Enabling the re-resolving of UDP address make the client more robust in Kubernetes deployments.

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger]
    disableAttemptReconnecting = false
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    disableAttemptReconnecting: false
```

```bash tab="CLI"
--tracing.jaeger.disableAttemptReconnecting=false
```

### `collector`
#### `endpoint`

_Optional, Default=""_

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

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger.collector]
    endpoint = "http://127.0.0.1:14268/api/traces?format=jaeger.thrift"
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    collector:
        endpoint: http://127.0.0.1:14268/api/traces?format=jaeger.thrift
```

```bash tab="CLI"
--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.

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger.collector]
    user = "my-user"
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    collector:
        user: my-user
```

```bash tab="CLI"
--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.

```toml tab="File (TOML)"
[tracing]
  [tracing.jaeger.collector]
    password = "my-password"
```

```yaml tab="File (YAML)"
tracing:
  jaeger:
    collector:
        password: my-password
```

```bash tab="CLI"
--tracing.jaeger.collector.password=my-password
```