github/containerd
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 2 Wiki Activity

Update tracing docs for containerd 2.0

Browse Source 
Signed-off-by: Austin Vazquez <macedonv@amazon.com>
This commit is contained in:
Austin Vazquez 2024-10-18 14:44:26 +00:00
parent d4cabf7179
commit 92d327af17
No known key found for this signature in database
GPG Key ID: 5F5F4008442CADB8
1 changed files with 23 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
docs/tracing.md
View File

@ -5,15 +5,9 @@ Tracing currently targets only gRPC calls.
## Sending traces from containerd daemon ## Sending traces from containerd daemon
By configuring `io.containerd.tracing.processor.v1.otlp` plugin. containerd daemon can send traces to collection endpoints by configuring
containerd daemon can send traces to the specified OpenTelemetry endpoint. [OpenTelemetry exporter environment variables](https://opentelemetry.io/docs/specs/otel/protocol/exporter/)
within the daemon's process space.
```toml
version = 2
[plugins."io.containerd.tracing.processor.v1.otlp"]
endpoint = "http://localhost:4318"
```
The following options are supported. The following options are supported.
@ -24,15 +18,28 @@ The following options are supported.
"http/protobuf" always uses the schema provided by the endpoint and "http/protobuf" always uses the schema provided by the endpoint and
the value of this setting being ignored. the value of this setting being ignored.
The sampling ratio and the service name on the traces could be configured by The sampling ratio and the service name on the traces can be configured by setting
`io.containerd.internal.v1.tracing` plugin. [OpenTelemetry environment variables](https://opentelemetry.io/docs/specs/otel/configuration/sdk-environment-variables/).
```toml For example, if running containerd as a systemd service, add the environment variables to the service:
version = 2
[plugins."io.containerd.internal.v1.tracing"] ```text
sampling_ratio = 1.0 [Service]
service_name = "containerd" Environment="OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318"
Environment="OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf"
Environment="OTEL_SERVICE_NAME=containerd"
Environment="OTEL_TRACES_SAMPLER=traceidratio"
Environment="OTEL_TRACES_SAMPLER_ARG=1.0"
```
Or if running containerd from the command-line, set the environment variables before starting the daemon:
```bash
export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"
export OTEL_EXPORTER_OTLP_PROTOCOL="http/protobuf"
export OTEL_SERVICE_NAME="containerd"
export OTEL_TRACES_SAMPLER="traceidratio"
export OTEL_TRACES_SAMPLER_ARG=1.0
``` ```
## Sending traces from containerd client ## Sending traces from containerd client