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

113 lines
1.8 KiB
Markdown
Raw Normal View History

---
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
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
```
```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"_
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
```
```toml tab="File (TOML)"
[tracing]
[tracing.datadog]
localAgentHostPort = "127.0.0.1:8126"
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
--tracing.datadog.localAgentHostPort=127.0.0.1:8126
2019-06-27 22:16:04 +00:00
```
#### `debug`
_Optional, Default=false_
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
```
```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_
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
```
```toml tab="File (TOML)"
[tracing]
[tracing.datadog]
globalTag = "sample"
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
--tracing.datadog.globalTag=sample
2019-06-27 22:16:04 +00:00
```
#### `prioritySampling`
_Optional, Default=false_
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
```
```toml tab="File (TOML)"
[tracing]
[tracing.datadog]
prioritySampling = true
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
--tracing.datadog.prioritySampling=true
```