caddy-website/src/docs/markdown/caddyfile/directives/tracing.md

title
tracing (Caddyfile directive)

tracing

It provides integration with OpenTelemetry tracing facilities.

When enabled, it will propagate an existing trace context or initialize a new one.

It is based on github.com/open-telemetry/opentelemetry-go.

It uses gRPC as an exporter protocol and W3C tracecontext and baggage as propagators.

Syntax

tracing {
	[span <span_name>]
}

• <span_name> - is a span name. Please see span naming guidelines.

Configuration

Environment variables

It can be configured using the environment variables defined by the OpenTelemetry Environment Variable Specification.

For the exporter configuration details, please see spec.

For example:

export OTEL_EXPORTER_OTLP_HEADERS="myAuthHeader=myToken,anotherHeader=value"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://my-otlp-endpoint:55680

Examples

Here is a Caddyfile example:

handle /myHandler {
	tracing {
		span my-span
	}
	reverse_proxy 127.0.0.1:8081
}