Configure Observability

Prometheus metrics, OpenTelemetry tracing, and request logging configuration for the interceptor

Warning

You are currently viewing v0.15 of the documentation and it is not the latest. For the most recent documentation, kindly click here.

The interceptor exposes metrics and tracing data to help monitor HTTP traffic and scaling behavior. All observability settings are configured via environment variables, set through the interceptor.extraEnvs Helm value.

Prometheus metrics

The interceptor exposes Prometheus metrics at /metrics on port 2223. This is enabled by default.

Env var	Default	Description
`OTEL_PROM_EXPORTER_ENABLED`	`true`	Enable the Prometheus metrics endpoint.
`OTEL_PROM_EXPORTER_PORT`	`2223`	Port for the Prometheus metrics endpoint.

See Metrics Reference for the full list of metrics and labels.

OpenTelemetry tracing

Enable distributed tracing via OTLP:

helm upgrade http-add-on kedacore/keda-add-ons-http \
  --namespace keda \
  --set interceptor.extraEnvs.OTEL_EXPORTER_OTLP_TRACES_ENABLED=true \
  --set interceptor.extraEnvs.OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=grpc \
  --set interceptor.extraEnvs.OTEL_EXPORTER_OTLP_ENDPOINT=http://<your-otel-collector>:4317

The interceptor uses W3C TraceContext and Baggage propagation.

Env var	Default	Description
`OTEL_EXPORTER_OTLP_TRACES_ENABLED`	`false`	Enable OTLP trace export.
`OTEL_EXPORTER_OTLP_TRACES_PROTOCOL`	`console`	Exporter protocol (`grpc`, `http/protobuf`, `console`).
`OTEL_EXPORTER_OTLP_ENDPOINT`	—	Collector endpoint URL.
`OTEL_EXPORTER_OTLP_HEADERS`	—	Authentication headers (e.g., `api-key=<token>`).
`OTEL_EXPORTER_OTLP_TRACES_TIMEOUT`	`10s`	Timeout for trace export requests.

OpenTelemetry metrics

Enable OTLP metrics export alongside or instead of Prometheus:

helm upgrade http-add-on kedacore/keda-add-ons-http \
  --namespace keda \
  --set interceptor.extraEnvs.OTEL_EXPORTER_OTLP_METRICS_ENABLED=true \
  --set interceptor.extraEnvs.OTEL_EXPORTER_OTLP_ENDPOINT=http://<your-otel-collector>:4317

Env var	Default	Description
`OTEL_EXPORTER_OTLP_METRICS_ENABLED`	`false`	Enable OTLP metrics export.
`OTEL_EXPORTER_OTLP_ENDPOINT`	—	Collector endpoint URL (shared with traces if set).
`OTEL_EXPORTER_OTLP_HEADERS`	—	Authentication headers (shared with traces if set).
`OTEL_METRIC_EXPORT_INTERVAL`	`60s`	Interval between periodic metric exports.

Request logging

Enable Combined Log Format request logging:

helm upgrade http-add-on kedacore/keda-add-ons-http \
  --namespace keda \
  --set interceptor.extraEnvs.KEDA_HTTP_LOG_REQUESTS=true

What’s Next

Metrics Reference — detailed Prometheus metric definitions.
Environment Variables Reference — all observability-related environment variables.