Tracing block

The tracing block is deprecated and will be removed in Cerbos 0.33.0. Refer to observability configuration for information about configuring traces.

Migrating tracing configuration from previous Cerbos versions

From Cerbos 0.32.0, the preferred method of trace configuration is through the OpenTelemetry environment variables described in observability configuration. The tracing section of the Cerbos configuration file is deprecated and will be removed in Cerbos 0.33.0. Native Jaeger protocol is deprecated as well and will be removed in Cerbos 0.33.0. Follow the instructions below to migrate your existing configuration.

Configuration setting New configuration

tracing.serviceName

Set OTEL_SERVICE_NAME environment variable

tracing.sampleProbability

Set OTEL_TRACES_SAMPLER to parentbased_traceidratio and OTEL_TRACES_SAMPLER_ARG to the probability value

tracing.jaeger.agentEndpoint or tracing.jaeger.collectorEndpoint

Jaeger now has stable support for OTLP and is the recommended way to send traces. Set OTEL_EXPORTER_OTLP_TRACES_ENDPOINT to the address of your Jaeger instance (for example: https://your.jaeger.instance:4317) and, optionally, set OTEL_EXPORTER_OTLP_TRACES_INSECURE=true if Jaeger is using a self-signed certificate. If you want to use the HTTP API or customize other aspects, refer to the documentation above for other supported environment variables.

tracing.otlp.collectorEndpoint

Set OTEL_EXPORTER_OTLP_TRACES_ENDPOINT to the value of the collector endpoint and OTEL_EXPORTER_OTLP_INSECURE=true to emulate the behaviour of Cerbos OTLP exporter before version 0.32.0.