Provided by: varnish_4.1.1-1ubuntu0.2_amd64 bug

NAME

       varnish-counters - Varnish counter field definitions

COUNTER LEVELS

       INFO  Informational counters
              Counters giving runtime information

       DIAG  Diagnostic counters
              Counters giving diagnostic information

       DEBUG  Debug counters
              Counters giving Varnish internals debug information

MAIN COUNTERS (MAIN.*)

       uptime  How long the child process has been running. (INFO)
              Child process uptime

       sess_conn  Count of sessions successfully accepted (INFO)
              Sessions accepted

       sess_drop  Count of sessions silently dropped due to lack of worker thread. (INFO)
              Sessions dropped

       sess_fail    Count  of  failures  to accept TCP connection. Either the client changed its
       mind, or the kernel ran out of some resource like file descriptors. (INFO)
              Session accept failures

       client_req_400  400 means we couldn't make sense of the request, it was malformed in some
       drastic way. (INFO)
              Client requests received, subject to 400 errors

       client_req_417  417 means that something went wrong with an Expect: header. (INFO)
              Client requests received, subject to 417 errors

       client_req  The count of parseable client requests seen. (INFO)
              Good client requests received

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

       cache_hitpass  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. (INFO)
              Cache hits for pass

       cache_miss  Count of misses A cache miss  indicates  the  object  was  fetched  from  the
       backend before delivering it to the backend. (INFO)
              Cache misses

       backend_conn  How many backend connections have successfully been established. (INFO)
              Backend conn. success

       backend_unhealthy  (INFO)
              Backend conn. not attempted

       backend_busy  (INFO)
              Backend conn. too many

       backend_fail  (INFO)
              Backend conn. failures

       backend_reuse    Count of backend connection reuses This counter is increased whenever we
       reuse a recycled connection. (INFO)
              Backend conn. reuses

       backend_recycle  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. (INFO)
              Backend conn. recycles

       backend_retry  (INFO)
              Backend conn. retry

       fetch_head  beresp with no body because the request is HEAD. (INFO)
              Fetch no body (HEAD)

       fetch_length  beresp.body with Content-Length. (INFO)
              Fetch with Length

       fetch_chunked  beresp.body with Chunked. (INFO)
              Fetch chunked

       fetch_eof  beresp.body with EOF. (INFO)
              Fetch EOF

       fetch_bad  beresp.body length/fetch could not be determined. (INFO)
              Fetch bad T-E

       fetch_none  beresp.body empty (INFO)
              Fetch no body

       fetch_1xx  beresp with no body because of 1XX response. (INFO)
              Fetch no body (1xx)

       fetch_204  beresp with no body because of 204 response. (INFO)
              Fetch no body (204)

       fetch_304  beresp with no body because of 304 response. (INFO)
              Fetch no body (304)

       fetch_failed  beresp fetch failed. (INFO)
              Fetch failed (all causes)

       fetch_no_thread  beresp fetch failed, no thread available. (INFO)
              Fetch failed (no thread)

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

       threads      Number   of   threads  in  all  pools.  See  also  parameters  thread_pools,
       thread_pool_min and thread_pool_max. (INFO)
              Total number of threads

       threads_limited  Number of times more threads were needed, but limit  was  reached  in  a
       thread pool. See also parameter thread_pool_max. (INFO)
              Threads hit max

       threads_created  Total number of threads created in all pools. (INFO)
              Threads created

       threads_destroyed  Total number of threads destroyed in all pools. (INFO)
              Threads destroyed

       threads_failed  Number of times creating a thread failed. See VSL::Debug for diagnostics.
       See also parameter thread_fail_delay. (INFO)
              Thread creation failed

       thread_queue_len  Length of session queue waiting for threads. NB: Only updates once  per
       second. See also parameter queue_max. (INFO)
              Length of session queue

       busy_sleep  Number of requests sent to sleep without a worker thread because they found a
       busy object. (INFO)
              Number of requests sent to sleep on busy objhdr

       busy_wakeup  Number of requests taken of the busy object sleep list and and  rescheduled.
       (INFO)
              Number of requests woken after sleep on busy objhdr

       busy_killed    Number  of  requests killed from the busy object sleep list due to lack of
       resources. (INFO)
              Number of requests killed after sleep on busy objhdr

       sess_queued  Number of times session was queued waiting for a thread. See also  parameter
       queue_max. (INFO)
              Sessions queued for thread

       sess_dropped    Number  of  times  session  was  dropped  because the queue were too long
       already. See also parameter queue_max. (INFO)
              Sessions dropped for thread

       n_object  Number of object structs made (INFO)
              object structs made

       n_vampireobject  Number of unresurrected objects (DIAG)
              unresurrected objects

       n_objectcore  Number of objectcore structs made (INFO)
              objectcore structs made

       n_objecthead  Number of objecthead structs made (INFO)
              objecthead structs made

       n_waitinglist  Number of waitinglist structs made (DEBUG)
              waitinglist structs made

       n_backend  Number of backends known to us. (INFO)
              Number of backends

       n_expired  Number of objects that expired from cache because of old age. (INFO)
              Number of expired objects

       n_lru_nuked  How many objects have been forcefully evicted from storage to make room  for
       a new object. (INFO)
              Number of LRU nuked objects

       n_lru_moved  Number of move operations done on the LRU list. (DIAG)
              Number of LRU moved objects

       losthdr  (INFO)
              HTTP header overflows

       s_sess  (INFO)
              Total sessions seen

       s_req  (INFO)
              Total requests seen

       s_pipe  (INFO)
              Total pipe sessions seen

       s_pass  (INFO)
              Total pass-ed requests seen

       s_fetch  (INFO)
              Total backend fetches initiated

       s_synth  (INFO)
              Total synthethic responses made

       s_req_hdrbytes  Total request header bytes received (INFO)
              Request header bytes

       s_req_bodybytes  Total request body bytes received (INFO)
              Request body bytes

       s_resp_hdrbytes  Total response header bytes transmitted (INFO)
              Response header bytes

       s_resp_bodybytes  Total response body bytes transmitted (INFO)
              Response body bytes

       s_pipe_hdrbytes  Total request bytes received for piped sessions (INFO)
              Pipe request header bytes

       s_pipe_in  Total number of bytes forwarded from clients in pipe sessions (INFO)
              Piped bytes from client

       s_pipe_out  Total number of bytes forwarded to clients in pipe sessions (INFO)
              Piped bytes to client

       sess_closed  (INFO)
              Session Closed

       sess_closed_err   Total number of sessions closed with errors. See sc_* diag counters for
       detailed breakdown (INFO)
              Session Closed with error

       sess_readahead  (INFO)
              Session Read Ahead

       sess_herd  (DIAG)
              Session herd

       sc_rem_close  Number of session closes with REM_CLOSE (Client Closed) (DIAG)
              Session OK  REM_CLOSE

       sc_req_close  Number of session closes with REQ_CLOSE (Client requested close) (DIAG)
              Session OK  REQ_CLOSE

       sc_req_http10  Number of session closes with Error REQ_HTTP10 (Proto < HTTP/1.1) (DIAG)
              Session Err REQ_HTTP10

       sc_rx_bad  Number of session closes with Error RX_BAD (Received bad req/resp) (DIAG)
              Session Err RX_BAD

       sc_rx_body  Number of session closes with  Error  RX_BODY  (Failure  receiving  req.body)
       (DIAG)
              Session Err RX_BODY

       sc_rx_junk  Number of session closes with Error RX_JUNK (Received junk data) (DIAG)
              Session Err RX_JUNK

       sc_rx_overflow    Number  of  session  closes  with  Error  RX_OVERFLOW  (Received buffer
       overflow) (DIAG)
              Session Err RX_OVERFLOW

       sc_rx_timeout  Number of session closes with Error RX_TIMEOUT (Receive timeout) (DIAG)
              Session Err RX_TIMEOUT

       sc_tx_pipe  Number of session closes with TX_PIPE (Piped transaction) (DIAG)
              Session OK  TX_PIPE

       sc_tx_error  Number of session closes with Error TX_ERROR (Error transaction) (DIAG)
              Session Err TX_ERROR

       sc_tx_eof  Number of session closes with TX_EOF (EOF transmission) (DIAG)
              Session OK  TX_EOF

       sc_resp_close  Number of session closes with  RESP_CLOSE  (Backend/VCL  requested  close)
       (DIAG)
              Session OK  RESP_CLOSE

       sc_overload  Number of session closes with Error OVERLOAD (Out of some resource) (DIAG)
              Session Err OVERLOAD

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

       sc_range_short  Number of session closes with Error RANGE_SHORT  (Insufficient  data  for
       range) (DIAG)
              Session Err RANGE_SHORT

       shm_records  (DIAG)
              SHM records

       shm_writes  (DIAG)
              SHM writes

       shm_flushes  (DIAG)
              SHM flushes due to overflow

       shm_cont  (DIAG)
              SHM MTX contention

       shm_cycles  (DIAG)
              SHM cycles through buffer

       backend_req  (INFO)
              Backend requests made

       n_vcl  (INFO)
              Number of loaded VCLs in total

       n_vcl_avail  (DIAG)
              Number of VCLs available

       n_vcl_discard  (DIAG)
              Number of discarded VCLs

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

       bans_completed  Number of bans which are  no  longer  active,  either  because  they  got
       checked by the ban-lurker or superseded by newer identical bans. (DIAG)
              Number of bans marked 'completed'

       bans_obj   Number of bans which use obj.* variables. These bans can possibly be washed by
       the ban-lurker. (DIAG)
              Number of bans using obj.*

       bans_req  Number of bans which use req.* variables. These bans can not be washed  by  the
       ban-lurker. (DIAG)
              Number of bans using req.*

       bans_added  Counter of bans added to ban list. (DIAG)
              Bans added

       bans_deleted  Counter of bans deleted from ban list. (DIAG)
              Bans deleted

       bans_tested    Count  of  how  many  bans and objects have been tested against each other
       during hash lookup. (DIAG)
              Bans tested against objects (lookup)

       bans_obj_killed  Number of objects killed by bans during object lookup. (DIAG)
              Objects killed by bans (lookup)

       bans_lurker_tested  Count of how many bans and objects  have  been  tested  against  each
       other by the ban-lurker. (DIAG)
              Bans tested against objects (lurker)

       bans_tests_tested    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' (DIAG)
              Ban tests tested against objects (lookup)

       bans_lurker_tests_tested    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' (DIAG)
              Ban tests tested against objects (lurker)

       bans_lurker_obj_killed  Number of objects killed by ban-lurker. (DIAG)
              Objects killed by bans (lurker)

       bans_dups  Count of bans replaced by later identical bans. (DIAG)
              Bans superseded by other bans

       bans_lurker_contention  Number of times the ban-lurker had to wait for lookups. (DIAG)
              Lurker gave way for lookup

       bans_persisted_bytes  Number of bytes used by the persisted ban lists. (DIAG)
              Bytes used by the persisted ban lists

       bans_persisted_fragmentation    Number  of  extra  bytes  accumulated through dropped and
       completed bans in the persistent ban lists. (DIAG)
              Extra bytes in persisted ban lists due to fragmentation

       n_purges  (INFO)
              Number of purge operations executed

       n_obj_purged  (INFO)
              Number of purged objects

       exp_mailed  Number of objects mailed to expiry thread for handling. (DIAG)
              Number of objects mailed to expiry thread

       exp_received  Number of objects received by expiry thread for handling. (DIAG)
              Number of objects received by expiry thread

       hcb_nolock  (DEBUG)
              HCB Lookups without lock

       hcb_lock  (DEBUG)
              HCB Lookups with lock

       hcb_insert  (DEBUG)
              HCB Inserts

       esi_errors  (DIAG)
              ESI parse errors (unlock)

       esi_warnings  (DIAG)
              ESI parse warnings (unlock)

       vmods  (INFO)
              Loaded VMODs

       n_gzip  (INFO)
              Gzip operations

       n_gunzip  (INFO)
              Gunzip operations

       vsm_free  Number of bytes free in the shared memory used to communicate with  tools  like
       varnishstat, varnishlog etc. (DIAG)
              Free VSM space

       vsm_used    Number of bytes used in the shared memory used to communicate with tools like
       varnishstat, varnishlog etc. (DIAG)
              Used VSM space

       vsm_cooling  Number of bytes which will soon (max 1 minute) be freed in the shared memory
       used to communicate with tools like varnishstat, varnishlog etc. (DEBUG)
              Cooling VSM space

       vsm_overflow  Number of bytes which does not fit in the shared memory used to communicate
       with tools like varnishstat, varnishlog etc. (DIAG)
              Overflow VSM space

       vsm_overflowed  Total number of bytes which did not fit in  the  shared  memory  used  to
       communicate with tools like varnishstat, varnishlog etc. (DIAG)
              Overflowed VSM space

MANAGEMENT PROCESS COUNTERS (MGT.*)

       uptime  Uptime in seconds of the management process (INFO)
              Management process uptime

       child_start  Number of times the child process has been started (DIAG)
              Child process started

       child_exit  Number of times the child process has been cleanly stopped (DIAG)
              Child process normal exit

       child_stop    Number of times the child process has exited with an unexpected return code
       (DIAG)
              Child process unexpected exit

       child_died  Number of times the child process has died due to signals (DIAG)
              Child process died (signal)

       child_dump  Number of times the child process has produced core dumps (DIAG)
              Child process core dumped

       child_panic  Number of times the management process has caught a child panic (DIAG)
              Child process panic

PER MEMORY POOL COUNTERS (MEMPOOL.*)

       live  (DEBUG)
              In use

       pool  (DEBUG)
              In Pool

       sz_wanted  (DEBUG)
              Size requested

       sz_actual  (DEBUG)
              Size allocated

       allocs  (DEBUG)
              Allocations

       frees  (DEBUG)
              Frees

       recycle  (DEBUG)
              Recycled from pool

       timeout  (DEBUG)
              Timed out from pool

       toosmall  (DEBUG)
              Too small to recycle

       surplus  (DEBUG)
              Too many for pool

       randry  (DEBUG)
              Pool ran dry

PER MALLOC STORAGE COUNTERS (SMA.*)

       c_req  Number of times the storage has been asked to provide a storage segment. (INFO)
              Allocator requests

       c_fail  Number of times the storage has failed to provide a storage segment. (INFO)
              Allocator failures

       c_bytes  Number of total bytes allocated by this storage. (INFO)
              Bytes allocated

       c_freed  Number of total bytes returned to this storage. (INFO)
              Bytes freed

       g_alloc  Number of storage allocations outstanding. (INFO)
              Allocations outstanding

       g_bytes  Number of bytes allocated from the storage. (INFO)
              Bytes outstanding

       g_space  Number of bytes left in the storage. (INFO)
              Bytes available

PER FILE STORAGE COUNTERS (SMF.*)

       c_req  Number of times the storage has been asked to provide a storage segment. (INFO)
              Allocator requests

       c_fail  Number of times the storage has failed to provide a storage segment. (INFO)
              Allocator failures

       c_bytes  Number of total bytes allocated by this storage. (INFO)
              Bytes allocated

       c_freed  Number of total bytes returned to this storage. (INFO)
              Bytes freed

       g_alloc  Number of storage allocations outstanding. (INFO)
              Allocations outstanding

       g_bytes  Number of bytes allocated from the storage. (INFO)
              Bytes outstanding

       g_space  Number of bytes left in the storage. (INFO)
              Bytes available

       g_smf  (INFO)
              N struct smf

       g_smf_frag  (INFO)
              N small free smf

       g_smf_large  (INFO)
              N large free smf

PER BACKEND COUNTERS (VBE.*)

       happy  (INFO)
              Happy health probes

       bereq_hdrbytes  Total backend request header bytes sent (INFO)
              Request header bytes

       bereq_bodybytes  Total backend request body bytes sent (INFO)
              Request body bytes

       beresp_hdrbytes  Total backend response header bytes received (INFO)
              Response header bytes

       beresp_bodybytes  Total backend response body bytes received (INFO)
              Response body bytes

       pipe_hdrbytes  Total request bytes sent for piped sessions (INFO)
              Pipe request header bytes

       pipe_out  Total number of bytes forwarded to backend in pipe sessions (INFO)
              Piped bytes to backend

       pipe_in  Total number of bytes forwarded from backend in pipe sessions (INFO)
              Piped bytes from backend

       conn  (INFO)
              Concurrent connections to backend

       req  (INFO)
              Backend requests sent

LOCK COUNTERS (LCK.*)

       creat  (DEBUG)
              Created locks

       destroy  (DEBUG)
              Destroyed locks

       locks  (DEBUG)
              Lock Operations

AUTHORS

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

                                                                              VARNISH-COUNTERS(7)