Metric Type
Display Name

Kind, Type, Unit

Description

Labels

/backend/data
Data

CUMULATIVE, INT64, By

Amount of data flowing to and from backend.

type: Data type ('body', 'header').

category: Data category ('backend request', 'pipe session').

/backend/requests
Requests

CUMULATIVE, INT64, Requests

Backend requests sent.

/backend/fetches/not_attempted_busy
Requests not Attempted due to Backend Being Busy

CUMULATIVE, INT64, n/a

Number of times the max_connections limit was reached.

/backend/fetches/not_attempted_unhealthy
Requests not Attempted due to Backend Being Unhealthy

CUMULATIVE, INT64, n/a

Fetches not attempted due to backend being unhealthy.

/backend/connections
Concurrent Connections

GAUGE, INT64, Connections

Concurrent connections to the backend.

/backend/connections/failed
Connection Failures

CUMULATIVE, INT64, Connections

Count of failures to create connection.

reason: Reason for connection failure.

/backend/connections/failed_total
Connections Failed

CUMULATIVE, INT64, Connections

All failed connections. All connections/failed_ counters may be slightly inaccurate for efficiency.*

/backend/connections/not_attempted
Connections Not Attempted

CUMULATIVE, INT64, Connections

Connections not attempted during the backend_local_error_holddown or backend_remote_error_holddown interval after a fundamental connection issue.

/cache/data
Data

CUMULATIVE, INT64, By

Amount of data flowing to and from backend.

type: Data type ('body', 'header').

category: Data category ('backend request', 'pipe session').

/cache/active_pipe_sessions
Active Pipe Sessions

GAUGE, INT64, Sessions

Number of ongoing pipe sessions.

/backend_connection_count
Backend connection successes

CUMULATIVE, INT64, Connections

Backend connection success count.

type: The backend connection type (either 'failures', 'not-attempted', 'recycled', 'reuses', 'success', 'too-many', 'unused', or 'was-closed'.

category: The Varnish metric category.

/cache/backend_connections/retried
Backend Connections Retried

CUMULATIVE, INT64, Connections

Number of times a connection to a backend was retried because a recycled connection was closed before we could reuse it.

/cache/backend_connections/too_late
Backend Connections Closed

CUMULATIVE, INT64, Connections

Number of times a connection to a backend was closed before we could reuse it. This metric only exists in version 3.X.

/cache/backend_requests
Backend Requests

CUMULATIVE, INT64, Requests

Number of Backend requests made.

/cache/backends
Number of backends

GAUGE, INT64, n/a

Number of backends known to Varnish.

/cache/bans/current
Current Bans

GAUGE, INT64, n/a

Number of all bans in system, including bans superseded by newer bans and bans already checked by the ban-lurker.

/cache/bans/added
Bans Added

CUMULATIVE, INT64, n/a

Number of bans added to ban list.

/cache/bans/completed
Bans Marked Completed

GAUGE, INT64, n/a

Number of bans which are no longer active, either because they got checked by the ban-lurker or superseded by newer identical bans.

/cache/bans/deleted
Bans Deleted

CUMULATIVE, INT64, n/a

Number of bans deleted from ban list.

/cache/bans/duplicated
Bans Superseded by Other Bans

CUMULATIVE, INT64, n/a

Number of bans replaced by later identical bans.

/cache/ban_lurker/contention
Ban-Lurker Waits for Lookup

CUMULATIVE, INT64, n/a

Number of times the ban-lurker had to wait for lookups.

/cache/ban_lurker/objects_killed
Objects Killed by Ban-Lurker

CUMULATIVE, INT64, n/a

Number of objects killed by the ban-lurker.

/cache/ban_lurker/objects_killed_cutoff
Objects Killed for Cutoff by Ban-Lurker

CUMULATIVE, INT64, n/a

Number of objects killed by the ban-lurker to keep the number of bans below ban_cutoff.

/cache/ban_lurker/tested
Bans Tested by Ban-Lurker

CUMULATIVE, INT64, n/a

Number of bans and objects tested against each other by the ban-lurker.

/cache/ban_lurker/tests_tested
Ban Tests Tested by Ban-Lurker

CUMULATIVE, INT64, n/a

Number of tests and objects tested against each other by the ban-lurker. 'ban req.url == foo && req.http.host == bar' counts as one in 'bans_tested' and as two in 'bans_tests_tested'.

/cache/bans/objects_killed
Objects Killed by Bans

CUMULATIVE, INT64, n/a

Number of objects killed by bans during object lookup.

/cache/bans/persisted_data
Persisted Ban Lists Size

GAUGE, INT64, By

Amount of data used by the persisted ban lists.

/cache/bans/persisted_fragmentation
Fragmentation in Persistent Ban Lists

GAUGE, INT64, By

Amount of extra data accumulated through dropped and completed bans in the persistent ban lists.

/cache/bans/tested
Bans Tested

CUMULATIVE, INT64, n/a

Number of bans and objects tested against each other during hash lookup.

/cache/bans/tests_tested
Ban Tests Tested

CUMULATIVE, INT64, n/a

Number of tests and objects tested against each other during lookup. 'ban req.url == foo && req.http.host == bar' counts as one in 'bans_tested' and as two in 'bans_tests_tested'.

/cache/bans/using_obj
Bans Using obj.*

GAUGE, INT64, n/a

Number of bans which use obj. variables. These bans can possibly be washed by the ban-lurker.*

/cache/bans/using_req
Bans Using req.*

GAUGE, INT64, n/a

Number of bans which use req. variables. These bans can not be washed by the ban-lurker.*

/cache/requests/busy_killed
Requests Killed after Sleep

CUMULATIVE, INT64, n/a

Number of requests killed from the busy object sleep list due to lack of resources.

/cache/requests/busy_sleep
Requests Sent to Sleep

CUMULATIVE, INT64, n/a

Number of requests sent to sleep without a worker thread because they found a busy object.

/cache/requests/busy_wakeup
Requests Woken after Sleep

CUMULATIVE, INT64, n/a

Number of requests taken off the busy object sleep list and rescheduled.

/cache_operation_count
Cache operations

CUMULATIVE, INT64, n/a

Cache operation count.

operation: The cache operation type (either 'hit', 'miss', or 'hitpass').

cache_name: The Varnish cache name suffixed with a metric category

/cache/child_process/dumps
Child Process Core Dumps

CUMULATIVE, INT64, n/a

Number of times the child process has produced core dumps.

/cache/child_process/starts
Child Process Starts

CUMULATIVE, INT64, n/a

Number of times the child process has been started.

/cache/child_process/stops
Child Process Stops

CUMULATIVE, INT64, n/a

Number of times the child process stopped.

reason: Reason that the child process stopped.

/cache/client_requests/dropped
Client Requests Dropped

CUMULATIVE, INT64, Connections

Number of times a client connection was closed before we could respond. This metric only exists in version 3.X.

/cache/client_requests/errors
Client Requests Received Subject to HTTP Errors

CUMULATIVE, INT64, n/a

Number of times a client received an HTTP error (4XX are client errors, 500 are Varnish errors).

type: Type of HTTP Error response ('400', '417', '500').

/cache/client_requests
Good Client Requests Received

CUMULATIVE, INT64, Requests

The count of parseable client requests.

/cache/dns_director/operations
DNS Director Operations

CUMULATIVE, INT64, n/a

Number of DNS director operations.

type: DNS Director operation ('cache hit', 'failed lookup', 'lookup').

/cache/dns_director/full_cache
DNS Director Full DNSCache

CUMULATIVE, INT64, n/a

Number of times the DNS Director lookup cache did not have space for new entries. This metric only exists in version 3.X.

/cache/esi/parse_errors
ESI Parse Errors

CUMULATIVE, INT64, n/a

Number of ESI parse errors (unlock).

/cache/esi/parse_warnings
ESI Parse Warnings

CUMULATIVE, INT64, n/a

Number of ESI parse warnings (unlock).

/cache/objects/expired
Expired Objects

CUMULATIVE, INT64, n/a

Number of objects that expired from cache because of old age.

/cache/objects/mailed_to_expiry
Objects Mailed to Expiry Thread

CUMULATIVE, INT64, n/a

Number of objects mailed to expiry thread for handling.

/cache/objects/received_by_expiry
Objects Received by Expiry Thread

CUMULATIVE, INT64, n/a

Number of objects received by expiry thread for handling.

/cache/fetches
Backend Fetches

CUMULATIVE, INT64, n/a

Number of fetches that Varnish executed against backends.

result: Result of backend request ('empty response', 'response', 'failed').

detail: Detailed reason for result of backend request if available.

/cache/fetches/total
Backend Fetches Initiated

CUMULATIVE, INT64, n/a

Number of backend fetches initiated.

/cache/gunzips
Gunzip Operations

CUMULATIVE, INT64, n/a

Number of gunzip operations.

/cache/gzips
Gzip Operations

CUMULATIVE, INT64, n/a

Number of gzip operations.

/cache/hcb/inserts
HCB Inserts

CUMULATIVE, INT64, n/a

Number of HCB Inserts.

/cache/hcb/lookups_lock
HCB Lookups with Lock

CUMULATIVE, INT64, n/a

Number of HCB Lookups with lock.

/cache/hcb/lookups_nolock
HCB Lookups without Lock

CUMULATIVE, INT64, n/a

Number of HCB Lookups without lock.

/cache/http_sessions/dropped
HTTP Sessions Dropped

CUMULATIVE, INT64, Sessions

Number of times an HTTP/1 session was dropped because the thread queue was too long already. See also parameter thread_queue_limit.

/cache/lost_headers
HTTP Header Overflows

CUMULATIVE, INT64, n/a

HTTP header overflows.

/cache/lru/limited
Nuke Limit Reached

CUMULATIVE, INT64, n/a

Number of times more storage space was needed, but limit was reached in a nuke_limit. See also parameter nuke_limit.

/cache/lru/moved_objects
LRU Moved Objects

CUMULATIVE, INT64, n/a

Number of move operations done on the LRU list.

/cache/lru/nuked_objects
LRU Nuked Objects

CUMULATIVE, INT64, n/a

Number of objects that have been forcefully evicted from storage to make room for a new object.

/cache/objectcores
Object Metadata Elements in Cache

GAUGE, INT64, n/a

Approximate number of object metadata elements in the cache. Each object needs an objectcore, extra objectcores are for hit-for-miss, hit-for-pass and busy objects.

/cache/objectheads
Hash Entries in Cache

GAUGE, INT64, n/a

Approximate number of different hash entries in the cache.

/cache/objects
Objects in Cache

GAUGE, INT64, n/a

Approximate number of HTTP objects (headers + body, if present) in the cache.

/cache/objects/overflowing
Objects Overflowing Workspace

CUMULATIVE, INT64, n/a

Number of objects overflowing workspace. This metric only exists in version 3.X.

/cache/objects/purged
Objects Purged

CUMULATIVE, INT64, n/a

Number of purged objects.

/cache/objects/sent_with_sendfile
Objects Sent with Sendfile

CUMULATIVE, INT64, n/a

Number of objects sent with sendfile. This metric only exists in version 3.X.

/cache/objects/sent_with_write
Objects Sent with Write

CUMULATIVE, INT64, n/a

Number of objects sent with write. This metric only exists in version 3.X.

/cache/requests/passes
Passed Requests

CUMULATIVE, INT64, Requests

Number of pass-ed requests seen by Varnish.

/cache/pipe_sessions
Pipe Sessions

CUMULATIVE, INT64, Sessions

Number of pipe sessions seen by Varnish.

/cache/pipe_sessions/limited
Pipes Limited

CUMULATIVE, INT64, Sessions

Number of times more pipes were needed, but the limit was reached. See also parameter pipe_sess_max.

/cache/purge_operations
Purge Operations

CUMULATIVE, INT64, n/a

Number of purge operations executed.

/cache/requests/dropped
Requests Dropped

CUMULATIVE, INT64, Requests

Number of times an HTTP/2 stream was refused because the thread queue was too long already. See also parameter thread_queue_limit.

/client_connection_count
Client connections

CUMULATIVE, INT64, Sessions

Client connection count.

type: the client connection type (either 'accepted', 'dropped', or 'received'

category: The Varnish metric category.

/cache/sessions/closed_total
Sessions Closed

CUMULATIVE, INT64, Sessions

Number of sessions closed.

/cache/sessions/closed
Session Closed

CUMULATIVE, INT64, Sessions

Number of sessions closed.

type: Overall reason for session close. ('error', ok')

reason: Detailed reason for session close.

/cache/sessions/closed_with_error
Session Closed with Error

CUMULATIVE, INT64, Sessions

Number of sessions closed with errors. This value is the sum of the error sessionsclosed Counters, which are detailed in sessions/closed.*

/cache/sessions/connected
Sessions Accepted

CUMULATIVE, INT64, Sessions

Count of sessions successfully accepted.

/cache/sessions/dropped
Sessions Dropped

CUMULATIVE, INT64, Sessions

Count of sessions silently dropped due to lack of worker thread.

/cache/sessions/failed_total
Session Accept Failures

CUMULATIVE, INT64, Sessions

Count of failures to accept TCP connection. This value is the sum of the sessionsfailed Counters, which are detailed in sessions/failed.*

/cache/sessions/failed
Session Accept Failures

CUMULATIVE, INT64, Sessions

Count of failures to accept TCP connection.

type: Type of session accept failure.

/cache/sessions/herded
Sessions Herded

CUMULATIVE, INT64, Sessions

Number of times the timeout_linger triggered and a session released its thread. This allows a thread to be shared between multiple request sessions while the backend processes a request.

/cache/sessions/linger
Sessions Lingering

CUMULATIVE, INT64, Sessions

Number of sessions reinitialized after use with the timeout_linger enabled. This metric only exists in version 3.X.

/cache/sessions/queued
Sessions Queued

CUMULATIVE, INT64, Sessions

Number of times session was queued waiting for a thread. See also parameter thread_queue_limit.

/cache/sessions/read_ahead
Sessions Read Ahead

CUMULATIVE, INT64, Sessions

Session read ahead.

/cache/sessions/with_pipelined_input
Sessions with Pipelined Input

CUMULATIVE, INT64, Sessions

Number of sessions reinitialized with pipelined input. This metric only exists in version 3.X.

/cache/shm/contention
SHM Mutex Contention

CUMULATIVE, INT64, n/a

Number of EBUSY errors when attempting to write to SHM.

/cache/shm/cycles
SHM Cycles

CUMULATIVE, INT64, n/a

Number of SHM cycles wrapping through buffer.

/cache/shm/flushes
SHM Flushes

CUMULATIVE, INT64, n/a

Number of SHM flushes due to overflow.

/cache/shm/records
SHM Records

CUMULATIVE, INT64, n/a

Number of SHM records.

/cache/shm/writes
SHM Writes

CUMULATIVE, INT64, n/a

Number of SHM writes.

/cache/summ_operations
Stat Summ Operations

CUMULATIVE, INT64, n/a

Number of times per-thread statistics were summed into the global Counters.

/cache/synthetic_responses
Synthetic Response

CUMULATIVE, INT64, n/a

Number of synthetic responses made by Varnish.

/cache/test_gunzips
Test Gunzip Operations

CUMULATIVE, INT64, n/a

Those operations occur when Varnish receives a compressed object from a backend. They are done to verify the gzip stream while it's inserted in storage.

/cache/thread_pools
Thread Pools

GAUGE, INT64, n/a

Number of thread pools (see also parameter thread_pools). Pools cannot be removed once created.

/cache/thread_queue_length
Length of Session Queue

GAUGE, INT64, n/a

Length of session queue waiting for threads. See also parameter thread_queue_limit.

/cache/threads
Number of Threads

GAUGE, INT64, n/a

Number of threads in all pools. See also parameters thread_pools, thread_pool_min and thread_pool_max.

/cache/threads/requested
Threads Requested

CUMULATIVE, INT64, n/a

Number of threads that Varnish attempted to create in thread pools.

result: Result of thread request ('created', 'failed', 'limited').

/cache/threads/destroyed
Threads Destroyed

CUMULATIVE, INT64, n/a

Number of threads destroyed in all pools.

/cache/uptime
Varnish Process Uptime

GAUGE, INT64, s

How long the Varnish processes have been running.

process: Process ('management', 'child').

/cache/objects/vampire
Unresurrected Objects

GAUGE, INT64, n/a

Number of unresurrected objects.

/cache/vbc
VBCs

GAUGE, INT64, n/a

Number of VBC structs. This metric only exists in version 3.X.

/cache/vcl
Loaded VLCs

GAUGE, INT64, n/a

Number of loaded VCLs in total.

/cache/vcl/available
VCLs Available

GAUGE, INT64, n/a

Number of VCLs available.

/cache/vcl/discarded
Discarded VCLs

GAUGE, INT64, n/a

Number of discarded VCLs.

/cache/vcl/failures
VCL Failures

CUMULATIVE, INT64, n/a

Number of failures which prevented VCL from completing.

/cache/vmods
Loaded VMODs

GAUGE, INT64, n/a

Number of loaded VMODs.

/cache/waiting_list
Hash Waiting List Size

GAUGE, INT64, n/a

Size of hash waiting list. This metric only exists in version 3.X.

/cache/workspace_overflows
Workspace Overflows

CUMULATIVE, INT64, n/a

Number of times Varnish ran out of space in workspaces.

workspace: Workspace that ran out of space ('backend', 'client', 'session', 'thread').

/lock_class/operations/contended
Contended Lock Operations

CUMULATIVE, INT64, n/a

Lock operations which returned EBUSY on the first locking attempt. If the lck debug bit is unset, this counter will never be incremented even if lock operations are contended.

/lock_class/operations/contended_trylock
Contended Trylock Operations

CUMULATIVE, INT64, n/a

Trylock operations which returned EBUSY. If the lck debug bit is unset, this counter will never be incremented even if lock operations are contended.

/lock_class/created
Created Locks

CUMULATIVE, INT64, n/a

Created locks.

/lock_class/destroyed
Destroyed Locks

CUMULATIVE, INT64, n/a

Destroyed locks.

/lock_class/operations
Lock Operations

CUMULATIVE, INT64, n/a

Lock Operations.

/memory_pool/allocations
Allocations

CUMULATIVE, INT64, n/a

Allocations on items in the pool.

/memory_pool/frees
Frees

CUMULATIVE, INT64, n/a

Free operations on items in use.

/memory_pool/items/in_pool
In Pool

GAUGE, INT64, n/a

Number of items available in memory pool.

/memory_pool/items/in_use
In Use

GAUGE, INT64, n/a

Number of items currently in use.

/memory_pool/ran_dry
Pool Ran Dry

CUMULATIVE, INT64, n/a

Number of times that no items were in pool when an allocation was attempted.

/memory_pool/items/recycled
Recycled Items

CUMULATIVE, INT64, n/a

Number of reused items from the pool.

/memory_pool/size_allocated
Size Allocated

GAUGE, INT64, By

Allocated size of the pool.

/memory_pool/size_requested
Size Requested

GAUGE, INT64, By

Requested size of the pool.

/memory_pool/items/surplus
Surplus Items Removed

CUMULATIVE, INT64, n/a

Number of items removed from pool because the maximum size was exceeded.

/memory_pool/items/timed_out
Timed Out Items Removed

CUMULATIVE, INT64, n/a

Number of items removed from pool because they had exceeded the maximum age since the last time used.

/memory_pool/items/too_small_to_recycle
Too Small to Recycle

CUMULATIVE, INT64, n/a

Number of items that were chosen for recycle but were too small.

/storage_device/allocated_data
Data Allocated

CUMULATIVE, INT64, By

Amount of data allocated by this storage.

/storage_device/allocations
Current Allocations

GAUGE, INT64, n/a

Number of storage allocations outstanding.

/storage_device/allocator_failures
Allocator Failures

CUMULATIVE, INT64, n/a

Number of times the storage has failed to provide a storage segment.

/storage_device/allocator_requests
Allocator Requests

CUMULATIVE, INT64, n/a

Number of times the storage has been asked to provide a storage segment.

/storage_device/available_space
Space Available

GAUGE, INT64, By

Amount of data left in the storage.

/storage_device/current_allocated_data
Current Allocated Data

GAUGE, INT64, By

Amount of data currently allocated from the storage.

/storage_device/file_allocations
Allocations on File

GAUGE, INT64, n/a

Number of allocated ranges on file. This metric is only available for File storage devices.

/storage_device/freed_data
Data Freed

CUMULATIVE, INT64, By

Amount of data returned to this storage.

/storage_device/large_file_allocations_free
Large File Allocations Free

GAUGE, INT64, n/a

Number of large free allocated ranges on file. This metric is only available for File storage devices.

/storage_device/small_file_allocations_free
Small File Allocations Free

GAUGE, INT64, n/a

Number of small free allocated ranges on file. This metric is only available for File storage devices.