2022-04-15 13:44:08 +00:00
|
|
|
---
|
|
|
|
title: "Traefik Datadog Tracing Documentation"
|
|
|
|
description: "Traefik Proxy supports Datadog for tracing. Read the technical documentation to enable Datadog for observability."
|
|
|
|
---
|
|
|
|
|
2019-09-02 10:18:04 +00:00
|
|
|
# Datadog
|
2019-06-27 22:16:04 +00:00
|
|
|
|
2021-09-29 08:40:14 +00:00
|
|
|
To enable the Datadog tracer:
|
2019-06-27 22:16:04 +00:00
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```yaml tab="File (YAML)"
|
|
|
|
tracing:
|
2019-09-02 10:18:04 +00:00
|
|
|
datadog: {}
|
2019-07-16 07:54:04 +00:00
|
|
|
```
|
|
|
|
|
2021-06-18 22:08:08 +00:00
|
|
|
```toml tab="File (TOML)"
|
|
|
|
[tracing]
|
|
|
|
[tracing.datadog]
|
|
|
|
```
|
|
|
|
|
2019-06-27 22:16:04 +00:00
|
|
|
```bash tab="CLI"
|
2019-07-22 07:58:04 +00:00
|
|
|
--tracing.datadog=true
|
2019-06-27 22:16:04 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
#### `localAgentHostPort`
|
|
|
|
|
|
|
|
_Required, Default="127.0.0.1:8126"_
|
|
|
|
|
2021-09-29 08:40:14 +00:00
|
|
|
Local Agent Host Port instructs the reporter to send spans to the Datadog Agent at this address (host:port).
|
2019-06-27 22:16:04 +00:00
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```yaml tab="File (YAML)"
|
|
|
|
tracing:
|
2019-09-02 10:18:04 +00:00
|
|
|
datadog:
|
2019-07-16 07:54:04 +00:00
|
|
|
localAgentHostPort: 127.0.0.1:8126
|
|
|
|
```
|
|
|
|
|
2021-06-18 22:08:08 +00:00
|
|
|
```toml tab="File (TOML)"
|
|
|
|
[tracing]
|
|
|
|
[tracing.datadog]
|
|
|
|
localAgentHostPort = "127.0.0.1:8126"
|
|
|
|
```
|
|
|
|
|
2019-06-27 22:16:04 +00:00
|
|
|
```bash tab="CLI"
|
2019-11-19 09:18:05 +00:00
|
|
|
--tracing.datadog.localAgentHostPort=127.0.0.1:8126
|
2019-06-27 22:16:04 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
#### `debug`
|
|
|
|
|
|
|
|
_Optional, Default=false_
|
|
|
|
|
2021-09-29 08:40:14 +00:00
|
|
|
Enables Datadog debug.
|
2019-06-27 22:16:04 +00:00
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```yaml tab="File (YAML)"
|
|
|
|
tracing:
|
2019-09-02 10:18:04 +00:00
|
|
|
datadog:
|
2019-07-16 07:54:04 +00:00
|
|
|
debug: true
|
|
|
|
```
|
|
|
|
|
2021-06-18 22:08:08 +00:00
|
|
|
```toml tab="File (TOML)"
|
|
|
|
[tracing]
|
|
|
|
[tracing.datadog]
|
|
|
|
debug = true
|
|
|
|
```
|
|
|
|
|
2019-06-27 22:16:04 +00:00
|
|
|
```bash tab="CLI"
|
|
|
|
--tracing.datadog.debug=true
|
|
|
|
```
|
|
|
|
|
|
|
|
#### `globalTag`
|
|
|
|
|
|
|
|
_Optional, Default=empty_
|
|
|
|
|
2021-09-29 08:40:14 +00:00
|
|
|
Applies a shared key:value tag on all spans.
|
2019-06-27 22:16:04 +00:00
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```yaml tab="File (YAML)"
|
|
|
|
tracing:
|
2019-09-02 10:18:04 +00:00
|
|
|
datadog:
|
2019-07-16 07:54:04 +00:00
|
|
|
globalTag: sample
|
|
|
|
```
|
|
|
|
|
2021-06-18 22:08:08 +00:00
|
|
|
```toml tab="File (TOML)"
|
|
|
|
[tracing]
|
|
|
|
[tracing.datadog]
|
|
|
|
globalTag = "sample"
|
|
|
|
```
|
|
|
|
|
2019-06-27 22:16:04 +00:00
|
|
|
```bash tab="CLI"
|
2019-11-19 09:18:05 +00:00
|
|
|
--tracing.datadog.globalTag=sample
|
2019-06-27 22:16:04 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
#### `prioritySampling`
|
|
|
|
|
|
|
|
_Optional, Default=false_
|
|
|
|
|
2021-09-29 08:40:14 +00:00
|
|
|
Enables priority sampling.
|
|
|
|
When using distributed tracing,
|
2019-06-27 22:16:04 +00:00
|
|
|
this option must be enabled in order to get all the parts of a distributed trace sampled.
|
|
|
|
|
2019-07-16 07:54:04 +00:00
|
|
|
```yaml tab="File (YAML)"
|
|
|
|
tracing:
|
2019-09-02 10:18:04 +00:00
|
|
|
datadog:
|
2019-07-16 07:54:04 +00:00
|
|
|
prioritySampling: true
|
|
|
|
```
|
|
|
|
|
2021-06-18 22:08:08 +00:00
|
|
|
```toml tab="File (TOML)"
|
|
|
|
[tracing]
|
|
|
|
[tracing.datadog]
|
|
|
|
prioritySampling = true
|
|
|
|
```
|
|
|
|
|
2019-06-27 22:16:04 +00:00
|
|
|
```bash tab="CLI"
|
|
|
|
--tracing.datadog.prioritySampling=true
|
|
|
|
```
|