Search

Varnish Otel 2.5.0 Release

Published June 9, 2026.

varnish-otel now supports using a Prometheus exporter via OTEL_METRICS_EXPORTER=prometheus. Metrics are exposed on an HTTP /metrics endpoint for Prometheus to scrape.

New environment variables:

  • OTEL_EXPORTER_PROMETHEUS_HOST: bind host for the /metrics endpoint, defaulting to localhost. When running in a container, set this to 0.0.0.0 to bind on all interfaces.
  • OTEL_EXPORTER_PROMETHEUS_PORT: bind port for the /metrics endpoint, defaulting to 9464.

Other changes:

  • MSE4_BOOK.<book_name>.c_ykey_iter_{10ms,100ms,1000ms,1000ms_up} are now translated into a single histogram metric varnish.mse4.book.ykey.duration_seconds.bucket with le attributes (0.01, 0.1, 1, +inf), eliminating the need for label_replace workarounds in dashboards.
  • Added build support for ubuntu:resolute (Ubuntu 26.04 LTS).
  • the new environment variable OTEL_VARNISH_DISABLE_LOGGERS can be set to true to preserve resource if logging data isn’t needed.
  • TraceID, SpanID, TraceFlags are now also exported as native top log attributes, instead of just as regular log attributes.

Important: TraceID, SpanID, TraceFlags as regular logs attributes are now deprecated and will be removed in the next major release.

References


®Varnish Software, Wallingatan 12, 111 60 Stockholm, Organization nr. 556805-6203