163 lines
2.8 KiB
Markdown
163 lines
2.8 KiB
Markdown
---
|
|
title: "Traefik Datadog Tracing Documentation"
|
|
description: "Traefik Proxy supports Datadog for tracing. Read the technical documentation to enable Datadog for observability."
|
|
---
|
|
|
|
# Datadog
|
|
|
|
To enable the Datadog tracer:
|
|
|
|
```yaml tab="File (YAML)"
|
|
tracing:
|
|
datadog: {}
|
|
```
|
|
|
|
```toml tab="File (TOML)"
|
|
[tracing]
|
|
[tracing.datadog]
|
|
```
|
|
|
|
```bash tab="CLI"
|
|
--tracing.datadog=true
|
|
```
|
|
|
|
#### `localAgentHostPort`
|
|
|
|
_Optional, Default="localhost:8126"_
|
|
|
|
Local Agent Host Port instructs the reporter to send spans to the Datadog Agent at this address (host:port).
|
|
|
|
```yaml tab="File (YAML)"
|
|
tracing:
|
|
datadog:
|
|
localAgentHostPort: localhost:8126
|
|
```
|
|
|
|
```toml tab="File (TOML)"
|
|
[tracing]
|
|
[tracing.datadog]
|
|
localAgentHostPort = "localhost:8126"
|
|
```
|
|
|
|
```bash tab="CLI"
|
|
--tracing.datadog.localAgentHostPort=localhost:8126
|
|
```
|
|
|
|
#### `localAgentSocket`
|
|
|
|
_Optional, Default=""_
|
|
|
|
Local Agent Socket instructs the reporter to send spans to the Datadog Agent at this UNIX socket.
|
|
|
|
```yaml tab="File (YAML)"
|
|
tracing:
|
|
datadog:
|
|
localAgentSocket: /var/run/datadog/apm.socket
|
|
```
|
|
|
|
```toml tab="File (TOML)"
|
|
[tracing]
|
|
[tracing.datadog]
|
|
localAgentSocket = "/var/run/datadog/apm.socket"
|
|
```
|
|
|
|
```bash tab="CLI"
|
|
--tracing.datadog.localAgentSocket=/var/run/datadog/apm.socket
|
|
```
|
|
|
|
#### `debug`
|
|
|
|
_Optional, Default=false_
|
|
|
|
Enables Datadog debug.
|
|
|
|
```yaml tab="File (YAML)"
|
|
tracing:
|
|
datadog:
|
|
debug: true
|
|
```
|
|
|
|
```toml tab="File (TOML)"
|
|
[tracing]
|
|
[tracing.datadog]
|
|
debug = true
|
|
```
|
|
|
|
```bash tab="CLI"
|
|
--tracing.datadog.debug=true
|
|
```
|
|
|
|
#### `globalTag`
|
|
|
|
??? warning "Deprecated in favor of the [`globalTags`](#globaltags) option."
|
|
|
|
_Optional, Default=empty_
|
|
|
|
Applies a shared key:value tag on all spans.
|
|
|
|
```yaml tab="File (YAML)"
|
|
tracing:
|
|
datadog:
|
|
globalTag: sample
|
|
```
|
|
|
|
```toml tab="File (TOML)"
|
|
[tracing]
|
|
[tracing.datadog]
|
|
globalTag = "sample"
|
|
```
|
|
|
|
```bash tab="CLI"
|
|
--tracing.datadog.globalTag=sample
|
|
```
|
|
|
|
#### `globalTags`
|
|
|
|
_Optional, Default=empty_
|
|
|
|
Applies a list of shared key:value tags on all spans.
|
|
|
|
```yaml tab="File (YAML)"
|
|
tracing:
|
|
datadog:
|
|
globalTags:
|
|
tag1: foo
|
|
tag2: bar
|
|
```
|
|
|
|
```toml tab="File (TOML)"
|
|
[tracing]
|
|
[tracing.datadog]
|
|
[tracing.datadog.globalTags]
|
|
tag1 = "foo"
|
|
tag2 = "bar"
|
|
```
|
|
|
|
```bash tab="CLI"
|
|
--tracing.datadog.globalTags.tag1=foo
|
|
--tracing.datadog.globalTags.tag2=bar
|
|
```
|
|
|
|
#### `prioritySampling`
|
|
|
|
_Optional, Default=false_
|
|
|
|
Enables priority sampling.
|
|
When using distributed tracing,
|
|
this option must be enabled in order to get all the parts of a distributed trace sampled.
|
|
|
|
```yaml tab="File (YAML)"
|
|
tracing:
|
|
datadog:
|
|
prioritySampling: true
|
|
```
|
|
|
|
```toml tab="File (TOML)"
|
|
[tracing]
|
|
[tracing.datadog]
|
|
prioritySampling = true
|
|
```
|
|
|
|
```bash tab="CLI"
|
|
--tracing.datadog.prioritySampling=true
|
|
```
|