Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Varnish metrics

The following table lists the metrics that are gathered as output from Varnish checks. Entries indicated as Featured metrics are high-visibility metrics that are displayed in the Operator Workspace Metric tab after an alert is generated. These metrics provide the operator with additional information to help them further explore the specified issue.

Metric typeResource (name of specific database, where relevant)UnitsMetric type description
MAIN_sess_conn (featured metric) countCumulative number of accepted client connections by Varnish Cache.
MAIN_sess_drop (featured metric) countNumber of connections dropped due to a full queue.
MAIN_client_req (featured metric) countCumulative number of received client requests. Increments after a request is received, but before Varnish responds.
MAIN_cache_hit countCumulative number of times a file was served from Varnish’s cache.
MAIN_cache_hitpass countCumulative number of hits for a “pass” file.
MAIN_cache_miss countCumulative number of times a file was requested but was not in the cache, and was therefore requested from the backend.
MAIN_backend_conn countCumulative number of successful TCP connections to the backend.
MAIN_backend_unhealthy (featured metric) countCumulative number of backend connections which were not attempted because the backend has been marked as unhealthy.
MAIN_backend_busy countCumulative number of times the maximum amount of connections to the backend has been reached.
MAIN_backend_fail (featured metric) countCumulative number of failed connections to the backend.
MAIN_backend_reuse (featured metric) countCumulative number of connections that were reused from the keep-alive pool.
MAIN_backend_recycle countCumulative number of current backend connections which were put back to a pool of keep-alive connections and have not yet been used.
MAIN_threads (featured metric) countNumber of threads in all pools.
MAIN_threads_limited countNumber of times a thread needed to be created but couldn't because varnishd maxed out its configured capacity for new threads.
MAIN_threads_created countNumber of times a thread has been created.
MAIN_threads_failed (featured metric) countNumber of times that Varnish unsuccessfully tried to create a thread.
MAIN_thread_queue_len countCurrent queue length: number of requests waiting on worker thread to become available.
MAIN_sess_queued countNumber of times Varnish has been out of threads and had to queue up a request.
MAIN_n_expired (featured metric) countCumulative number of expired objects for example due to TTL.
MAIN_n_lru_nuked (featured metric) countLeast Recently Used Nuked Objects: Cumulative number of cached objects that Varnish has evicted from the cache because of a lack of space.
MAIN_backend_req (featured metric) countNumber of requests to the backend.

Parent Topic:Agent Client Collector Monitoring default checks and policies