2019-06-27 22:16:04 +00:00
|
|
|
# Tracing
|
|
|
|
|
|
|
|
Visualize the Requests Flow
|
|
|
|
{: .subtitle }
|
|
|
|
|
|
|
|
The tracing system allows developers to visualize call flows in their infrastructure.
|
|
|
|
|
|
|
|
Traefik uses OpenTracing, an open standard designed for distributed tracing.
|
|
|
|
|
|
|
|
Traefik supports five tracing backends:
|
|
|
|
|
|
|
|
- [Jaeger](./jaeger.md)
|
|
|
|
- [Zipkin](./zipkin.md)
|
|
|
|
- [DataDog](./datadog.md)
|
|
|
|
- [Instana](./instana.md)
|
|
|
|
- [Haystack](./haystack.md)
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
|
|
By default, Traefik uses Jaeger as tracing backend.
|
|
|
|
|
|
|
|
To enable the tracing:
|
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```toml tab="File (TOML)"
|
2019-06-27 22:16:04 +00:00
|
|
|
[tracing]
|
|
|
|
```
|
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```yaml tab="File (YAML)"
|
|
|
|
tracing: {}
|
|
|
|
```
|
|
|
|
|
2019-06-27 22:16:04 +00:00
|
|
|
```bash tab="CLI"
|
2019-07-22 07:58:04 +00:00
|
|
|
--tracing=true
|
2019-06-27 22:16:04 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
### Common Options
|
|
|
|
|
|
|
|
#### `serviceName`
|
|
|
|
|
|
|
|
_Required, Default="traefik"_
|
|
|
|
|
|
|
|
Service name used in selected backend.
|
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```toml tab="File (TOML)"
|
2019-06-27 22:16:04 +00:00
|
|
|
[tracing]
|
|
|
|
serviceName = "traefik"
|
|
|
|
```
|
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```yaml tab="File (YAML)"
|
|
|
|
tracing:
|
|
|
|
serviceName: traefik
|
|
|
|
```
|
|
|
|
|
2019-06-27 22:16:04 +00:00
|
|
|
```bash tab="CLI"
|
|
|
|
--tracing.serviceName="traefik"
|
|
|
|
```
|
|
|
|
|
|
|
|
#### `spanNameLimit`
|
|
|
|
|
|
|
|
_Required, Default=0_
|
|
|
|
|
|
|
|
Span name limit allows for name truncation in case of very long names.
|
|
|
|
This can prevent certain tracing providers to drop traces that exceed their length limits.
|
|
|
|
|
|
|
|
`0` means no truncation will occur.
|
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```toml tab="File (TOML)"
|
2019-06-27 22:16:04 +00:00
|
|
|
[tracing]
|
|
|
|
spanNameLimit = 150
|
|
|
|
```
|
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```yaml tab="File (YAML)"
|
|
|
|
tracing:
|
|
|
|
spanNameLimit: 150
|
|
|
|
```
|
|
|
|
|
2019-06-27 22:16:04 +00:00
|
|
|
```bash tab="CLI"
|
|
|
|
--tracing.spanNameLimit=150
|
|
|
|
```
|