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

290 lines
5.3 KiB
Markdown
Raw Normal View History

2019-06-27 22:16:04 +00:00
# Jaeger
To enable the Jaeger tracer:
2019-06-27 22:16:04 +00:00
2019-07-16 07:54:04 +00:00
```yaml tab="File (YAML)"
tracing:
jaeger: {}
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger]
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
2019-07-22 07:58:04 +00:00
--tracing.jaeger=true
2019-06-27 22:16:04 +00:00
```
!!! warning
2019-07-15 12:52:04 +00:00
Traefik is able to send data over the compact thrift protocol to the [Jaeger agent](https://www.jaegertracing.io/docs/deployment/#agent)
or a [Jaeger collector](https://www.jaegertracing.io/docs/deployment/#collectors).
2019-06-27 22:16:04 +00:00
!!! info
All Jaeger configuration can be overridden by [environment variables](https://github.com/jaegertracing/jaeger-client-go#environment-variables)
2019-06-27 22:16:04 +00:00
#### `samplingServerURL`
_Required, Default="http://localhost:5778/sampling"_
Address of the Jaeger Agent HTTP sampling server.
2019-06-27 22:16:04 +00:00
2019-07-16 07:54:04 +00:00
```yaml tab="File (YAML)"
tracing:
jaeger:
samplingServerURL: http://localhost:5778/sampling
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger]
samplingServerURL = "http://localhost:5778/sampling"
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
--tracing.jaeger.samplingServerURL=http://localhost:5778/sampling
2019-06-27 22:16:04 +00:00
```
#### `samplingType`
_Required, Default="const"_
Type of the sampler.
Valid values are:
- `const`
- `probabilistic`
- `rateLimiting`
2019-06-27 22:16:04 +00:00
2019-07-16 07:54:04 +00:00
```yaml tab="File (YAML)"
tracing:
jaeger:
samplingType: const
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger]
samplingType = "const"
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
--tracing.jaeger.samplingType=const
2019-06-27 22:16:04 +00:00
```
#### `samplingParam`
_Required, Default=1.0_
Value passed to the sampler.
2019-06-27 22:16:04 +00:00
Valid values are:
2019-06-27 22:16:04 +00:00
- for `const` sampler, 0 or 1 for always false/true respectively
- for `probabilistic` sampler, a probability between 0 and 1
- for `rateLimiting` sampler, the number of spans per second
2019-07-16 07:54:04 +00:00
```yaml tab="File (YAML)"
tracing:
jaeger:
samplingParam: 1.0
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger]
samplingParam = 1.0
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
--tracing.jaeger.samplingParam=1.0
2019-06-27 22:16:04 +00:00
```
#### `localAgentHostPort`
_Required, Default="127.0.0.1:6831"_
Local Agent Host Port instructs the reporter to send spans to the Jaeger 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:
jaeger:
localAgentHostPort: 127.0.0.1:6831
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger]
localAgentHostPort = "127.0.0.1:6831"
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
--tracing.jaeger.localAgentHostPort=127.0.0.1:6831
2019-06-27 22:16:04 +00:00
```
#### `gen128Bit`
_Optional, Default=false_
Generates 128 bits trace IDs, compatible with OpenCensus.
2019-06-27 22:16:04 +00:00
2019-07-16 07:54:04 +00:00
```yaml tab="File (YAML)"
tracing:
jaeger:
gen128Bit: true
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger]
gen128Bit = true
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
--tracing.jaeger.gen128Bit
```
#### `propagation`
_Required, Default="jaeger"_
Sets the propagation header type.
Valid values are:
2019-06-27 22:16:04 +00:00
- `jaeger`, jaeger's default trace header.
- `b3`, compatible with OpenZipkin
2019-07-16 07:54:04 +00:00
```yaml tab="File (YAML)"
tracing:
jaeger:
propagation: jaeger
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger]
propagation = "jaeger"
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
--tracing.jaeger.propagation=jaeger
2019-06-27 22:16:04 +00:00
```
#### `traceContextHeaderName`
_Required, Default="uber-trace-id"_
HTTP header name used to propagate tracing context.
2019-06-27 22:16:04 +00:00
This must be in lower-case to avoid mismatches when decoding incoming headers.
2019-07-16 07:54:04 +00:00
```yaml tab="File (YAML)"
tracing:
jaeger:
traceContextHeaderName: uber-trace-id
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger]
traceContextHeaderName = "uber-trace-id"
```
2019-06-27 22:16:04 +00:00
```bash tab="CLI"
--tracing.jaeger.traceContextHeaderName=uber-trace-id
2019-06-27 22:16:04 +00:00
```
2019-07-15 12:52:04 +00:00
### disableAttemptReconnecting
_Optional, Default=true_
Disables the UDP connection helper that periodically re-resolves the agent's hostname and reconnects if there was a change.
Enabling the re-resolving of UDP address make the client more robust in Kubernetes deployments.
```yaml tab="File (YAML)"
tracing:
jaeger:
disableAttemptReconnecting: false
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger]
disableAttemptReconnecting = false
```
```bash tab="CLI"
--tracing.jaeger.disableAttemptReconnecting=false
```
2019-07-15 12:52:04 +00:00
### `collector`
#### `endpoint`
_Optional, Default=""_
Collector Endpoint instructs the reporter to send spans to the Jaeger Collector at this URL.
2019-07-15 12:52:04 +00:00
2019-07-16 07:54:04 +00:00
```yaml tab="File (YAML)"
tracing:
jaeger:
collector:
endpoint: http://127.0.0.1:14268/api/traces?format=jaeger.thrift
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger.collector]
endpoint = "http://127.0.0.1:14268/api/traces?format=jaeger.thrift"
```
2019-07-15 12:52:04 +00:00
```bash tab="CLI"
--tracing.jaeger.collector.endpoint=http://127.0.0.1:14268/api/traces?format=jaeger.thrift
2019-07-15 12:52:04 +00:00
```
#### `user`
_Optional, Default=""_
User instructs the reporter to include a user for basic HTTP authentication when sending spans to the Jaeger Collector.
2019-07-15 12:52:04 +00:00
2019-07-16 07:54:04 +00:00
```yaml tab="File (YAML)"
tracing:
jaeger:
collector:
user: my-user
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger.collector]
user = "my-user"
```
2019-07-15 12:52:04 +00:00
```bash tab="CLI"
--tracing.jaeger.collector.user=my-user
2019-07-15 12:52:04 +00:00
```
#### `password`
_Optional, Default=""_
Password instructs the reporter to include a password for basic HTTP authentication when sending spans to the Jaeger Collector.
2019-07-15 12:52:04 +00:00
2019-07-16 07:54:04 +00:00
```yaml tab="File (YAML)"
tracing:
jaeger:
collector:
password: my-password
```
```toml tab="File (TOML)"
[tracing]
[tracing.jaeger.collector]
password = "my-password"
```
2019-07-15 12:52:04 +00:00
```bash tab="CLI"
--tracing.jaeger.collector.password=my-password
2019-07-15 12:52:04 +00:00
```