177 lines
4.1 KiB
Markdown
177 lines
4.1 KiB
Markdown
# Tracing
|
|
|
|
The tracing system allows developers to visualize call flows in their infrastructure.
|
|
|
|
We use [OpenTracing](http://opentracing.io). It is an open standard designed for distributed tracing.
|
|
|
|
Træfik supports three tracing backends: Jaeger, Zipkin and DataDog.
|
|
|
|
## Jaeger
|
|
|
|
```toml
|
|
# Tracing definition
|
|
[tracing]
|
|
# Backend name used to send tracing data
|
|
#
|
|
# Default: "jaeger"
|
|
#
|
|
backend = "jaeger"
|
|
|
|
# Service name used in Jaeger backend
|
|
#
|
|
# Default: "traefik"
|
|
#
|
|
serviceName = "traefik"
|
|
|
|
# Span name limit allows for name truncation in case of very long Frontend/Backend names
|
|
# This can prevent certain tracing providers to drop traces that exceed their length limits
|
|
#
|
|
# Default: 0 - no truncation will occur
|
|
#
|
|
spanNameLimit = 0
|
|
|
|
[tracing.jaeger]
|
|
# Sampling Server URL is the address of jaeger-agent's HTTP sampling server
|
|
#
|
|
# Default: "http://localhost:5778/sampling"
|
|
#
|
|
samplingServerURL = "http://localhost:5778/sampling"
|
|
|
|
# Sampling Type specifies the type of the sampler: const, probabilistic, rateLimiting
|
|
#
|
|
# Default: "const"
|
|
#
|
|
samplingType = "const"
|
|
|
|
# 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
|
|
#
|
|
# Default: 1.0
|
|
#
|
|
samplingParam = 1.0
|
|
|
|
# Local Agent Host Port instructs reporter to send spans to jaeger-agent at this address
|
|
#
|
|
# Default: "127.0.0.1:6831"
|
|
#
|
|
localAgentHostPort = "127.0.0.1:6831"
|
|
|
|
# Generate 128-bit trace IDs, compatible with OpenCensus
|
|
#
|
|
# Default: false
|
|
gen128Bit = true
|
|
|
|
# Set the propagation header type. This can be either:
|
|
# - "jaeger", jaeger's default trace header.
|
|
# - "b3", compatible with OpenZipkin
|
|
#
|
|
# Default: "jaeger"
|
|
propagation = "jaeger"
|
|
```
|
|
|
|
!!! warning
|
|
Træfik is only able to send data over compact thrift protocol to the [Jaeger agent](https://www.jaegertracing.io/docs/deployment/#agent).
|
|
|
|
## Zipkin
|
|
|
|
```toml
|
|
# Tracing definition
|
|
[tracing]
|
|
# Backend name used to send tracing data
|
|
#
|
|
# Default: "jaeger"
|
|
#
|
|
backend = "zipkin"
|
|
|
|
# Service name used in Zipkin backend
|
|
#
|
|
# Default: "traefik"
|
|
#
|
|
serviceName = "traefik"
|
|
|
|
# Span name limit allows for name truncation in case of very long Frontend/Backend names
|
|
# This can prevent certain tracing providers to drop traces that exceed their length limits
|
|
#
|
|
# Default: 0 - no truncation will occur
|
|
#
|
|
spanNameLimit = 150
|
|
|
|
[tracing.zipkin]
|
|
# Zipkin HTTP endpoint used to send data
|
|
#
|
|
# Default: "http://localhost:9411/api/v1/spans"
|
|
#
|
|
httpEndpoint = "http://localhost:9411/api/v1/spans"
|
|
|
|
# Enable Zipkin debug
|
|
#
|
|
# Default: false
|
|
#
|
|
debug = false
|
|
|
|
# Use Zipkin SameSpan RPC style traces
|
|
#
|
|
# Default: false
|
|
#
|
|
sameSpan = false
|
|
|
|
# Use Zipkin 128 bit root span IDs
|
|
#
|
|
# Default: true
|
|
#
|
|
id128Bit = true
|
|
|
|
# The rate between 0.0 and 1.0 of requests to trace.
|
|
#
|
|
# Default: 1.0
|
|
#
|
|
sampleRate = 0.2
|
|
```
|
|
|
|
## DataDog
|
|
|
|
```toml
|
|
# Tracing definition
|
|
[tracing]
|
|
# Backend name used to send tracing data
|
|
#
|
|
# Default: "jaeger"
|
|
#
|
|
backend = "datadog"
|
|
|
|
# Service name used in DataDog backend
|
|
#
|
|
# Default: "traefik"
|
|
#
|
|
serviceName = "traefik"
|
|
|
|
# Span name limit allows for name truncation in case of very long Frontend/Backend names
|
|
# This can prevent certain tracing providers to drop traces that exceed their length limits
|
|
#
|
|
# Default: 0 - no truncation will occur
|
|
#
|
|
spanNameLimit = 100
|
|
|
|
[tracing.datadog]
|
|
# Local Agent Host Port instructs reporter to send spans to datadog-tracing-agent at this address
|
|
#
|
|
# Default: "127.0.0.1:8126"
|
|
#
|
|
localAgentHostPort = "127.0.0.1:8126"
|
|
|
|
# Enable DataDog debug
|
|
#
|
|
# Default: false
|
|
#
|
|
debug = false
|
|
|
|
# Apply shared tag in a form of Key:Value to all the traces
|
|
#
|
|
# Default: ""
|
|
#
|
|
globalTag = ""
|
|
|
|
```
|