varnish-counters

VARNISH-COUNTERS(7)                                        VARNISH-COUNTERS(7)



NAME
       varnish-counters - Varnish counter field definitions

MAIN â MAIN COUNTERS
       summs â counter - debug
          stat summ operations

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

       uptime â counter - info
          Child process uptime

          How long the child process has been running.

       sess_conn â counter - info
          Sessions accepted

          Count of sessions successfully accepted

       sess_drop â counter - info
          Sessions dropped

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

       sess_fail â counter - info
          Session accept failures

          Count of failures to accept TCP connection.

          This counter is the sum of the sess_fail_* counters, which give more
          detailed information.

       sess_fail_econnaborted â counter - info
          Session accept failures: connection aborted

          Detailed reason for sess_fail: Connection aborted by the client,
          usually harmless.

       sess_fail_eintr â counter - info
          Session accept failures: interrupted system call

          Detailed reason for sess_fail: The accept() call was interrupted,
          usually harmless

       sess_fail_emfile â counter - info
          Session accept failures: too many open files

          Detailed reason for sess_fail: No file descriptor was available.
          Consider raising RLIMIT_NOFILE (see ulimit -n).

       sess_fail_ebadf â counter - info
          Session accept failures: bad file descriptor

          Detailed reason for sess_fail: The listen socket file descriptor was
          invalid. Should never happen.

       sess_fail_enomem â counter - info
          Session accept failures: not enough memory

          Detailed reason for sess_fail: Most likely insufficient socket
          buffer memory. Should never happen

       sess_fail_other â counter - info
          Session accept failures: other

          Detailed reason for sess_fail: neither of the above, see SessError
          log (varnishlog -g raw -i SessError).

       client_req_400 â counter - info
          Client requests received, subject to 400 errors

          400 means we couldn't make sense of the request, it was malformed in
          some drastic way.

       client_req_417 â counter - info
          Client requests received, subject to 417 errors

          417 means that something went wrong with an Expect: header.

       client_req â counter - info
          Good client requests received

          The count of parseable client requests seen.

       cache_hit â counter - info
          Cache hits

          Count of cache hits.  A cache hit indicates that an object has been
          delivered to a client without fetching it from a backend server.

       cache_hit_grace â counter - info
          Cache grace hits

          Count of cache hits with grace. A cache hit with grace is a cache
          hit where the object is expired. Note that such hits are also
          included in the cache_hit counter.

       cache_hitpass â counter - info
          Cache hits for pass.

          Count of hits for pass. A cache hit for pass indicates that Varnish
          is going to pass the request to the backend and this decision has
          been cached in it self. This counts how many times the cached
          decision is being used.

       cache_hitmiss â counter - info
          Cache hits for miss.

          Count of hits for miss. A cache hit for miss indicates that Varnish
          is going to proceed as for a cache miss without request coalescing,
          and this decision has been cached. This counts how many times the
          cached decision is being used.

       cache_miss â counter - info
          Cache misses

          Count of misses. A cache miss indicates the object was fetched from
          the backend before delivering it to the client.

       backend_conn â counter - info
          Backend conn. success

          How many backend connections have successfully been established.

       backend_unhealthy â counter - info
          Backend conn. not attempted

       backend_busy â counter - info
          Backend conn. too many

       backend_fail â counter - info
          Backend conn. failures

       backend_reuse â counter - info
          Backend conn. reuses

          Count of backend connection reuses. This counter is increased
          whenever we reuse a recycled connection.

       backend_recycle â counter - info
          Backend conn. recycles

          Count of backend connection recycles. This counter is increased
          whenever we have a keep-alive connection that is put back into the
          pool of connections. It has not yet been used, but it might be,
          unless the backend closes it.

       backend_retry â counter - info
          Backend conn. retry

       fetch_head â counter - info
          Fetch no body (HEAD)

          beresp with no body because the request is HEAD.

       fetch_length â counter - info
          Fetch with Length

          beresp.body with Content-Length.

       fetch_chunked â counter - info
          Fetch chunked

          beresp.body with Chunked.

       fetch_eof â counter - info
          Fetch EOF

          beresp.body with EOF.

       fetch_bad â counter - info
          Fetch bad T-E

          beresp.body length/fetch could not be determined.

       fetch_none â counter - info
          Fetch no body

          beresp.body empty

       fetch_1xx â counter - info
          Fetch no body (1xx)

          beresp with no body because of 1XX response.

       fetch_204 â counter - info
          Fetch no body (204)

          beresp with no body because of 204 response.

       fetch_304 â counter - info
          Fetch no body (304)

          beresp with no body because of 304 response.

       fetch_failed â counter - info
          Fetch failed (all causes)

          beresp fetch failed.

       fetch_no_thread â counter - info
          Fetch failed (no thread)

          beresp fetch failed, no thread available.

       pools â gauge - info
          Number of thread pools

          Number of thread pools. See also parameter thread_pools. NB:
          Presently pools cannot be removed once created.

       threads â gauge - info
          Total number of threads

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

       threads_limited â counter - info
          Threads hit max

          Number of times more threads were needed, but limit was reached in a
          thread pool. See also parameter thread_pool_max.

       threads_created â counter - info
          Threads created

          Total number of threads created in all pools.

       threads_destroyed â counter - info
          Threads destroyed

          Total number of threads destroyed in all pools.

       threads_failed â counter - info
          Thread creation failed

          Number of times creating a thread failed. See VSL::Debug for
          diagnostics. See also parameter thread_fail_delay.

       thread_queue_len â gauge - info
          Length of session queue

          Length of session queue waiting for threads. NB: Only updates once
          per second. See also parameter thread_queue_limit.

       busy_sleep â counter - info
          Number of requests sent to sleep on busy objhdr

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

       busy_wakeup â counter - info
          Number of requests woken after sleep on busy objhdr

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

       busy_killed â counter - info
          Number of requests killed after sleep on busy objhdr

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

       sess_queued â counter - info
          Sessions queued for thread

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

       sess_dropped â counter - info
          Sessions dropped for thread

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

       req_dropped â counter - info
          Requests dropped

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

       n_object â gauge - info
          object structs made

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

       n_vampireobject â gauge - diag
          unresurrected objects

          Number of unresurrected objects

       n_objectcore â gauge - info
          objectcore structs made

          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.

       n_objecthead â gauge - info
          objecthead structs made

          Approximate number of different hash entries in the cache.

       n_backend â gauge - info
          Number of backends

          Number of backends known to us.

       n_expired â counter - info
          Number of expired objects

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

       n_lru_nuked â counter - info
          Number of LRU nuked objects

          How many objects have been forcefully evicted from storage to make
          room for a new object.

       n_lru_moved â counter - diag
          Number of LRU moved objects

          Number of move operations done on the LRU list.

       n_lru_limited â counter - info
          Reached nuke_limit

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

       losthdr â counter - info
          HTTP header overflows

       s_sess â counter - info
          Total sessions seen

       n_pipe â gauge - info
          Number of ongoing pipe sessions

       pipe_limited â counter - info
          Pipes hit pipe_sess_max

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

       s_pipe â counter - info
          Total pipe sessions seen

       s_pass â counter - info
          Total pass-ed requests seen

       s_fetch â counter - info
          Total backend fetches initiated

       s_synth â counter - info
          Total synthetic responses made

       s_req_hdrbytes â counter - info
          Request header bytes

          Total request header bytes received

       s_req_bodybytes â counter - info
          Request body bytes

          Total request body bytes received

       s_resp_hdrbytes â counter - info
          Response header bytes

          Total response header bytes transmitted

       s_resp_bodybytes â counter - info
          Response body bytes

          Total response body bytes transmitted

       s_pipe_hdrbytes â counter - info
          Pipe request header bytes

          Total request bytes received for piped sessions

       s_pipe_in â counter - info
          Piped bytes from client

          Total number of bytes forwarded from clients in pipe sessions

       s_pipe_out â counter - info
          Piped bytes to client

          Total number of bytes forwarded to clients in pipe sessions

       sess_closed â counter - info
          Session Closed

       sess_closed_err â counter - info
          Session Closed with error

          Total number of sessions closed with errors. See sc_* diag counters
          for detailed breakdown

       sess_readahead â counter - info
          Session Read Ahead

       sess_herd â counter - diag
          Session herd

          Number of times the timeout_linger triggered

       sc_rem_close â counter - diag
          Session OK  REM_CLOSE

          Number of session closes with REM_CLOSE (Client Closed)

       sc_req_close â counter - diag
          Session OK  REQ_CLOSE

          Number of session closes with REQ_CLOSE (Client requested close)

       sc_req_http10 â counter - diag
          Session Err REQ_HTTP10

          Number of session closes with Error REQ_HTTP10 (Proto < HTTP/1.1)

       sc_rx_bad â counter - diag
          Session Err RX_BAD

          Number of session closes with Error RX_BAD (Received bad req/resp)

       sc_rx_body â counter - diag
          Session Err RX_BODY

          Number of session closes with Error RX_BODY (Failure receiving
          req.body)

       sc_rx_junk â counter - diag
          Session Err RX_JUNK

          Number of session closes with Error RX_JUNK (Received junk data)

       sc_rx_overflow â counter - diag
          Session Err RX_OVERFLOW

          Number of session closes with Error RX_OVERFLOW (Received buffer
          overflow)

       sc_rx_timeout â counter - diag
          Session Err RX_TIMEOUT

          Number of session closes with Error RX_TIMEOUT (Receive timeout)

       sc_tx_pipe â counter - diag
          Session OK  TX_PIPE

          Number of session closes with TX_PIPE (Piped transaction)

       sc_tx_error â counter - diag
          Session Err TX_ERROR

          Number of session closes with Error TX_ERROR (Error transaction)

       sc_tx_eof â counter - diag
          Session OK  TX_EOF

          Number of session closes with TX_EOF (EOF transmission)

       sc_resp_close â counter - diag
          Session OK  RESP_CLOSE

          Number of session closes with RESP_CLOSE (Backend/VCL requested
          close)

       sc_overload â counter - diag
          Session Err OVERLOAD

          Number of session closes with Error OVERLOAD (Out of some resource)

       sc_pipe_overflow â counter - diag
          Session Err PIPE_OVERFLOW

          Number of session closes with Error PIPE_OVERFLOW (Session pipe
          overflow)

       sc_range_short â counter - diag
          Session Err RANGE_SHORT

          Number of session closes with Error RANGE_SHORT (Insufficient data
          for range)

       sc_req_http20 â counter - diag
          Session Err REQ_HTTP20

          Number of session closes with Error REQ_HTTP20 (HTTP2 not accepted)

       sc_vcl_failure â counter - diag
          Session Err VCL_FAILURE

          Number of session closes with Error VCL_FAILURE (VCL failure)

       client_resp_500 â counter - diag
          Delivery failed due to insufficient workspace.

          Number of times we failed a response due to running out of workspace
          memory during delivery.

       ws_backend_overflow â counter - diag
          workspace_backend overflows

          Number of times we ran out of space in workspace_backend.

       ws_client_overflow â counter - diag
          workspace_client overflows

          Number of times we ran out of space in workspace_client.

       ws_thread_overflow â counter - diag
          workspace_thread overflows

          Number of times we ran out of space in workspace_thread.

       ws_session_overflow â counter - diag
          workspace_session overflows

          Number of times we ran out of space in workspace_session.

       shm_records â counter - diag
          SHM records

       shm_writes â counter - diag
          SHM writes

       shm_flushes â counter - diag
          SHM flushes due to overflow

       shm_cont â counter - diag
          SHM MTX contention

       shm_cycles â counter - diag
          SHM cycles through buffer

       backend_req â counter - info
          Backend requests made

       n_vcl â gauge - info
          Number of loaded VCLs in total

       n_vcl_avail â gauge - diag
          Number of VCLs available

       n_vcl_discard â gauge - diag
          Number of discarded VCLs

       vcl_fail â counter - info
          VCL failures

          Count of failures which prevented VCL from completing.

       bans â gauge - info
          Count of bans

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

       bans_completed â gauge - diag
          Number of bans marked 'completed'

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

       bans_obj â gauge - diag
          Number of bans using obj.*

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

       bans_req â gauge - diag
          Number of bans using req.*

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

       bans_added â counter - diag
          Bans added

          Counter of bans added to ban list.

       bans_deleted â counter - diag
          Bans deleted

          Counter of bans deleted from ban list.

       bans_tested â counter - diag
          Bans tested against objects (lookup)

          Count of how many bans and objects have been tested against each
          other during hash lookup.

       bans_obj_killed â counter - diag
          Objects killed by bans (lookup)

          Number of objects killed by bans during object lookup.

       bans_lurker_tested â counter - diag
          Bans tested against objects (lurker)

          Count of how many bans and objects have been tested against each
          other by the ban-lurker.

       bans_tests_tested â counter - diag
          Ban tests tested against objects (lookup)

          Count of how many tests and objects have been 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'

       bans_lurker_tests_tested â counter - diag
          Ban tests tested against objects (lurker)

          Count of how many tests and objects have been 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'

       bans_lurker_obj_killed â counter - diag
          Objects killed by bans (lurker)

          Number of objects killed by the ban-lurker.

       bans_lurker_obj_killed_cutoff â counter - diag
          Objects killed by bans for cutoff (lurker)

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

       bans_dups â counter - diag
          Bans superseded by other bans

          Count of bans replaced by later identical bans.

       bans_lurker_contention â counter - diag
          Lurker gave way for lookup

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

       bans_persisted_bytes â gauge - diag
          Bytes used by the persisted ban lists

          Number of bytes used by the persisted ban lists.

       bans_persisted_fragmentation â gauge - diag
          Extra bytes in persisted ban lists due to fragmentation

          Number of extra bytes accumulated through dropped and completed bans
          in the persistent ban lists.

       n_purges â counter - info
          Number of purge operations executed

       n_obj_purged â counter - info
          Number of purged objects

       exp_mailed â counter - diag
          Number of objects mailed to expiry thread

          Number of objects mailed to expiry thread for handling.

       exp_received â counter - diag
          Number of objects received by expiry thread

          Number of objects received by expiry thread for handling.

       hcb_nolock â counter - debug
          HCB Lookups without lock

       hcb_lock â counter - debug
          HCB Lookups with lock

       hcb_insert â counter - debug
          HCB Inserts

       esi_errors â counter - diag
          ESI parse errors (unlock)

       esi_warnings â counter - diag
          ESI parse warnings (unlock)

       vmods â gauge - info
          Loaded VMODs

       n_gzip â counter - info
          Gzip operations

       n_gunzip â counter - info
          Gunzip operations

       n_test_gunzip â counter - info
          Test gunzip operations

          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.

MGT â MANAGEMENT PROCESS COUNTERS
       uptime â counter - info
          Management process uptime

          Uptime in seconds of the management process

       child_start â counter - diag
          Child process started

          Number of times the child process has been started

       child_exit â counter - diag
          Child process normal exit

          Number of times the child process has been cleanly stopped

       child_stop â counter - diag
          Child process unexpected exit

          Number of times the child process has exited with an unexpected
          return code

       child_died â counter - diag
          Child process died (signal)

          Number of times the child process has died due to signals

       child_dump â counter - diag
          Child process core dumped

          Number of times the child process has produced core dumps

       child_panic â counter - diag
          Child process panic

          Number of times the management process has caught a child panic

MEMPOOL â MEMORY POOL COUNTERS
       live â gauge - debug
          In use

       pool â gauge - debug
          In Pool

       sz_wanted â gauge - debug
          Size requested

       sz_actual â gauge - debug
          Size allocated

       allocs â counter - debug
          Allocations

       frees â counter - debug
          Frees

       recycle â counter - debug
          Recycled from pool

       timeout â counter - debug
          Timed out from pool

       toosmall â counter - debug
          Too small to recycle

       surplus â counter - debug
          Too many for pool

       randry â counter - debug
          Pool ran dry

SMA â MALLOC STEVEDORE COUNTERS
       c_req â counter - info
          Allocator requests

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

       c_fail â counter - info
          Allocator failures

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

       c_bytes â counter - info
          Bytes allocated

          Number of total bytes allocated by this storage.

       c_freed â counter - info
          Bytes freed

          Number of total bytes returned to this storage.

       g_alloc â gauge - info
          Allocations outstanding

          Number of storage allocations outstanding.

       g_bytes â gauge - info
          Bytes outstanding

          Number of bytes allocated from the storage.

       g_space â gauge - info
          Bytes available

          Number of bytes left in the storage.

SMU â UMEM STEVEDORE COUNTERS
       c_req â counter - info
          Allocator requests

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

       c_fail â counter - info
          Allocator failures

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

       c_bytes â counter - info
          Bytes allocated

          Number of total bytes allocated by this storage.

       c_freed â counter - info
          Bytes freed

          Number of total bytes returned to this storage.

       g_alloc â gauge - info
          Allocations outstanding

          Number of storage allocations outstanding.

       g_bytes â gauge - info
          Bytes outstanding

          Number of bytes allocated from the storage.

       g_space â gauge - info
          Bytes available

          Number of bytes left in the storage.

SMF â FILE STEVEDORE COUNTERS
       c_req â counter - info
          Allocator requests

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

       c_fail â counter - info
          Allocator failures

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

       c_bytes â counter - info
          Bytes allocated

          Number of total bytes allocated by this storage.

       c_freed â counter - info
          Bytes freed

          Number of total bytes returned to this storage.

       g_alloc â gauge - info
          Allocations outstanding

          Number of storage allocations outstanding.

       g_bytes â gauge - info
          Bytes outstanding

          Number of bytes allocated from the storage.

       g_space â gauge - info
          Bytes available

          Number of bytes left in the storage.

       g_smf â gauge - info
          N struct smf

       g_smf_frag â gauge - info
          N small free smf

       g_smf_large â gauge - info
          N large free smf

VBE â BACKEND COUNTERS
       happy â bitmap - info
          Happy health probes

       bereq_hdrbytes â counter - info
          Request header bytes

          Total backend request header bytes sent

       bereq_bodybytes â counter - info
          Request body bytes

          Total backend request body bytes sent

       beresp_hdrbytes â counter - info
          Response header bytes

          Total backend response header bytes received

       beresp_bodybytes â counter - info
          Response body bytes

          Total backend response body bytes received

       pipe_hdrbytes â counter - info
          Pipe request header bytes

          Total request bytes sent for piped sessions

       pipe_out â counter - info
          Piped bytes to backend

          Total number of bytes forwarded to backend in pipe sessions

       pipe_in â counter - info
          Piped bytes from backend

          Total number of bytes forwarded from backend in pipe sessions

       conn â gauge - info
          Concurrent connections to backend

       req â counter - info
          Backend requests sent

       unhealthy â counter - info
          Fetches not attempted due to backend being unhealthy

       busy â counter - info
          Fetches not attempted due to backend being busy

          Number of times the max_connections limit was reached

       fail â counter - info
          Connections failed

          Counter of failed opens. Detailed reasons are given in the fail_*
          counters (DIAG level) and in the log under the FetchError tag.

          This counter is the sum of all detailed fail_* counters.

          All fail_* counters may be slightly inaccurate for efficiency.

       fail_eacces â counter - diag
          Connections failed with EACCES or EPERM

       fail_eaddrnotavail â counter - diag
          Connections failed with EADDRNOTAVAIL

       fail_econnrefused â counter - diag
          Connections failed with ECONNREFUSED

       fail_enetunreach â counter - diag
          Connections failed with ENETUNREACH

       fail_etimedout â counter - diag
          Connections failed ETIMEDOUT

       fail_other â counter - diag
          Connections failed for other reason

       helddown â counter - diag
          Connection opens not attempted

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

LCK â LOCK COUNTERS
          Counters which track the activity in the different classes of
          mutex-locks.

          The counts may be slightly wrong if there are more than one lock
          instantiated in each class (ie: .creat > 1)

       creat â counter - debug
          Created locks

       destroy â counter - debug
          Destroyed locks

       locks â counter - debug
          Lock Operations

       dbg_busy â counter - debug
          Contended lock operations

          If the lck debug bit is set: 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.

       dbg_try_fail â counter - debug
          Contended trylock operations

          If the lck debug bit is set: Trylock operations which returned
          EBUSY.

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

AUTHORS
       This man page was written by Lasse Karstensen, using content from
       vsc2rst written by Tollef Fog Heen.



                                                           VARNISH-COUNTERS(7)