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

title	description
Traefik Tracing Overview	The Traefik Proxy tracing system allows developers to visualize call flows in their infrastructure. Read the full documentation.

Tracing

Visualize the Requests Flow {: .subtitle }

The tracing system allows developers to visualize call flows in their infrastructure.

Traefik uses OpenTelemetry, an open standard designed for distributed tracing.

Please check our dedicated OTel docs to learn more.

Configuration

To enable the tracing:

tracing: {}

[tracing]

--tracing=true

Common Options

serviceName

Required, Default="traefik"

Service name used in selected backend.

tracing:
  serviceName: traefik

[tracing]
  serviceName = "traefik"

--tracing.serviceName=traefik

sampleRate

Optional, Default=1.0

The proportion of requests to trace, specified between 0.0 and 1.0.

tracing:
  sampleRate: 0.2

[tracing]
    sampleRate = 0.2

--tracing.sampleRate=0.2

headers

Optional, Default={}

Defines additional headers to be sent with the span's payload.

tracing:
  headers:
    foo: bar
    baz: buz

[tracing]
    [tracing.headers]
        foo = "bar"
        baz = "buz"

--tracing.headers.foo=bar --tracing.headers.baz=buz

globalAttributes

Optional, Default=empty

Applies a list of shared key:value attributes on all spans.

tracing:
  globalAttributes:
    attr1: foo
    attr2: bar

[tracing]
    [tracing.globalAttributes]
      attr1 = "foo"
      attr2 = "bar"

--tracing.globalAttributes.attr1=foo
--tracing.globalAttributes.attr2=bar