OpenTelemetry

Configuration for the integrated OpenTelemetry exporter. A recognizable service_name should be set, and at least one endpoint. All other parameters are optional.

otel:
  service_name: example
  metrics:
    endpoint: http://prometheus:9090/api/v1/otlp/v1/metrics

service_name string#

otel:
  service_name: example

Default: varnish-supervisor

Service name for metrics identification

metrics#

Metrics exporter configuration.

enabled boolean#

otel:
  metrics:
    enabled: false

Default: true

Enable metrics export.

endpoint string#

otel:
  metrics:
    endpoint: http://prometheus:9090/api/v1/otlp/v1/metrics

OpenTelemetry endpoint URL for metrics export.

protocol string#

otel:
  metrics:
    protocol: grpc

Default: http/protobuf

Options:

• http/protobuf
• grpc
• http/json

Protocol to use when exporting metrics.

export_interval integer#

otel:
  metrics:
    export_interval: 30

Default: 60

Metrics export interval in seconds.

tracing#

Note: Orca Premium feature

enabled boolean#

otel:
  tracing:
    enabled: true

Default: false

Enable tracing export. Requires the vmod-otel license addon.

endpoint string#

otel:
  tracing:
    endpoint: http://prometheus:9090/api/v1/otlp/v1/metrics

OpenTelemetry endpoint URL for trace export.

protocol string#

otel:
  tracing:
    protocol: grpc

Default: http/protobuf

Options:

• http/protobuf
• grpc
• http/json

Protocol to use when exporting traces.

export_interval integer#

otel:
  tracing:
    export_interval: 5

Default: 5

Tracing batch export interval in seconds.

sampler string#

otel:
  tracing:
    sampler: parentbased_traceidratio

Default: always_on

Trace sampler type. Controls how traces are sampled.

Options:

• always_on: Sample all traces.
• always_off: Sample no traces.
• traceidratio: Sample a fraction of traces based on sampler_arg.
• parentbased_always_on: Follow parent span’s sampling decision, default to always on.
• parentbased_always_off: Follow parent span’s sampling decision, default to always off.
• parentbased_traceidratio: Follow parent span’s sampling decision, default to ratio-based.

sampler_arg number#

otel:
  tracing:
    sampler: traceidratio
    sampler_arg: 0.1

Default: 1.0

Sampler argument for ratio-based samplers. A value between 0.0 (sample nothing) and 1.0 (sample everything).

logs#

Logs exporter configuration.

enabled boolean#

otel:
  logs:
    enabled: true

Default: true (when endpoint is configured)

Enable logs export.

endpoint string#

otel:
  logs:
    endpoint: http://loki:3100/otlp/v1/logs

OTLP endpoint URL for logs export. When empty, logs export is disabled.

protocol string#

otel:
  logs:
    protocol: grpc

Default: http/protobuf

Options:

• http/protobuf
• grpc
• http/json

Protocol to use when exporting logs.

export_interval integer#

otel:
  logs:
    export_interval: 10

Default: 5

Logs export interval in seconds.