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

82 lines
1.3 KiB
Markdown
Raw Normal View History

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"
--tracing
```
### 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
--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
--tracing.spanNameLimit=150
```