1VARNISH-COUNTERS(7) VARNISH-COUNTERS(7)
2
6 varnish-counters - Varnish counter field definitions
7
9 summs – counter - debug
10 stat summ operations
11 Number of times per-thread statistics were summed into the global
13 counters.
14 uptime – counter - info
16 Child process uptime
17 How long the child process has been running.
19 sess_conn – counter - info
21 Sessions accepted
22 Count of sessions successfully accepted
24 sess_drop – counter - info
26 Sessions dropped
27 Count of sessions silently dropped due to lack of worker thread.
29 sess_fail – counter - info
31 Session accept failures
32 Count of failures to accept TCP connection.
34 This counter is the sum of the sess_fail_* counters, which give more
36 detailed information.
37 sess_fail_econnaborted – counter - info
39 Session accept failures: connection aborted
40 Detailed reason for sess_fail: Connection aborted by the client,
42 usually harmless.
43 sess_fail_eintr – counter - info
45 Session accept failures: interrupted system call
46 Detailed reason for sess_fail: The accept() call was interrupted,
48 usually harmless
49 sess_fail_emfile – counter - info
51 Session accept failures: too many open files
52 Detailed reason for sess_fail: No file descriptor was available.
54 Consider raising RLIMIT_NOFILE (see ulimit -n).
55 sess_fail_ebadf – counter - info
57 Session accept failures: bad file descriptor
58 Detailed reason for sess_fail: The listen socket file descriptor was
60 invalid. Should never happen.
61 sess_fail_enomem – counter - info
63 Session accept failures: not enough memory
64 Detailed reason for sess_fail: Most likely insufficient socket buf‐
66 fer memory. Should never happen
67 sess_fail_other – counter - info
69 Session accept failures: other
70 Detailed reason for sess_fail: neither of the above, see Debug log
72 (varnishlog -g raw -I Debug:^Accept).
73 client_req_400 – counter - info
75 Client requests received, subject to 400 errors
76 400 means we couldn't make sense of the request, it was malformed in
78 some drastic way.
79 client_req_417 – counter - info
81 Client requests received, subject to 417 errors
82 417 means that something went wrong with an Expect: header.
84 client_req – counter - info
86 Good client requests received
87 The count of parseable client requests seen.
89 cache_hit – counter - info
91 Cache hits
92 Count of cache hits. A cache hit indicates that an object has been
94 delivered to a client without fetching it from a backend server.
95 cache_hit_grace – counter - info
97 Cache grace hits
98 Count of cache hits with grace. A cache hit with grace is a cache
100 hit where the object is expired. Note that such hits are also
101 included in the cache_hit counter.
102 cache_hitpass – counter - info
104 Cache hits for pass.
105 Count of hits for pass. A cache hit for pass indicates that Varnish
107 is going to pass the request to the backend and this decision has
108 been cached in it self. This counts how many times the cached deci‐
109 sion is being used.
110 cache_hitmiss – counter - info
112 Cache hits for miss.
113 Count of hits for miss. A cache hit for miss indicates that Varnish
115 is going to proceed as for a cache miss without request coalescing,
116 and this decision has been cached. This counts how many times the
117 cached decision is being used.
118 cache_miss – counter - info
120 Cache misses
121 Count of misses. A cache miss indicates the object was fetched from
123 the backend before delivering it to the client.
124 backend_conn – counter - info
126 Backend conn. success
127 How many backend connections have successfully been established.
129 backend_unhealthy – counter - info
131 Backend conn. not attempted
132 backend_busy – counter - info
134 Backend conn. too many
135 backend_fail – counter - info
137 Backend conn. failures
138 backend_reuse – counter - info
140 Backend conn. reuses
141 Count of backend connection reuses. This counter is increased when‐
143 ever we reuse a recycled connection.
144 backend_recycle – counter - info
146 Backend conn. recycles
147 Count of backend connection recycles. This counter is increased
149 whenever we have a keep-alive connection that is put back into the
150 pool of connections. It has not yet been used, but it might be,
151 unless the backend closes it.
152 backend_retry – counter - info
154 Backend conn. retry
155 fetch_head – counter - info
157 Fetch no body (HEAD)
158 beresp with no body because the request is HEAD.
160 fetch_length – counter - info
162 Fetch with Length
163 beresp.body with Content-Length.
165 fetch_chunked – counter - info
167 Fetch chunked
168 beresp.body with Chunked.
170 fetch_eof – counter - info
172 Fetch EOF
173 beresp.body with EOF.
175 fetch_bad – counter - info
177 Fetch bad T-E
178 beresp.body length/fetch could not be determined.
180 fetch_none – counter - info
182 Fetch no body
183 beresp.body empty
185 fetch_1xx – counter - info
187 Fetch no body (1xx)
188 beresp with no body because of 1XX response.
190 fetch_204 – counter - info
192 Fetch no body (204)
193 beresp with no body because of 204 response.
195 fetch_304 – counter - info
197 Fetch no body (304)
198 beresp with no body because of 304 response.
200 fetch_failed – counter - info
202 Fetch failed (all causes)
203 beresp fetch failed.
205 fetch_no_thread – counter - info
207 Fetch failed (no thread)
208 beresp fetch failed, no thread available.
210 pools – gauge - info
212 Number of thread pools
213 Number of thread pools. See also parameter thread_pools. NB:
215 Presently pools cannot be removed once created.
216 threads – gauge - info
218 Total number of threads
219 Number of threads in all pools. See also parameters thread_pools,
221 thread_pool_min and thread_pool_max.
222 threads_limited – counter - info
224 Threads hit max
225 Number of times more threads were needed, but limit was reached in a
227 thread pool. See also parameter thread_pool_max.
228 threads_created – counter - info
230 Threads created
231 Total number of threads created in all pools.
233 threads_destroyed – counter - info
235 Threads destroyed
236 Total number of threads destroyed in all pools.
238 threads_failed – counter - info
240 Thread creation failed
241 Number of times creating a thread failed. See VSL::Debug for diag‐
243 nostics. See also parameter thread_fail_delay.
244 thread_queue_len – gauge - info
246 Length of session queue
247 Length of session queue waiting for threads. NB: Only updates once
249 per second. See also parameter thread_queue_limit.
250 busy_sleep – counter - info
252 Number of requests sent to sleep on busy objhdr
253 Number of requests sent to sleep without a worker thread because
255 they found a busy object.
256 busy_wakeup – counter - info
258 Number of requests woken after sleep on busy objhdr
259 Number of requests taken off the busy object sleep list and resched‐
261 uled.
262 busy_killed – counter - info
264 Number of requests killed after sleep on busy objhdr
265 Number of requests killed from the busy object sleep list due to
267 lack of resources.
268 sess_queued – counter - info
270 Sessions queued for thread
271 Number of times session was queued waiting for a thread. See also
273 parameter thread_queue_limit.
274 sess_dropped – counter - info
276 Sessions dropped for thread
277 Number of times an HTTP/1 session was dropped because the queue was
279 too long already. See also parameter thread_queue_limit.
280 req_dropped – counter - info
282 Requests dropped
283 Number of times an HTTP/2 stream was refused because the queue was
285 too long already. See also parameter thread_queue_limit.
286 n_object – gauge - info
288 object structs made
289 Approximate number of HTTP objects (headers + body, if present) in
291 the cache.
292 n_vampireobject – gauge - diag
294 unresurrected objects
295 Number of unresurrected objects
297 n_objectcore – gauge - info
299 objectcore structs made
300 Approximate number of object metadata elements in the cache. Each
302 object needs an objectcore, extra objectcores are for hit-for-miss,
303 hit-for-pass and busy objects.
304 n_objecthead – gauge - info
306 objecthead structs made
307 Approximate number of different hash entries in the cache.
309 n_backend – gauge - info
311 Number of backends
312 Number of backends known to us.
314 n_expired – counter - info
316 Number of expired objects
317 Number of objects that expired from cache because of old age.
319 n_lru_nuked – counter - info
321 Number of LRU nuked objects
322 How many objects have been forcefully evicted from storage to make
324 room for a new object.
325 n_lru_moved – counter - diag
327 Number of LRU moved objects
328 Number of move operations done on the LRU list.
330 n_lru_limited – counter - info
332 Reached nuke_limit
333 Number of times more storage space were needed, but limit was
335 reached in a nuke_limit. See also parameter nuke_limit.
336 losthdr – counter - info
338 HTTP header overflows
339 s_sess – counter - info
341 Total sessions seen
342 s_pipe – counter - info
344 Total pipe sessions seen
345 s_pass – counter - info
347 Total pass-ed requests seen
348 s_fetch – counter - info
350 Total backend fetches initiated
351 s_synth – counter - info
353 Total synthetic responses made
354 s_req_hdrbytes – counter - info
356 Request header bytes
357 Total request header bytes received
359 s_req_bodybytes – counter - info
361 Request body bytes
362 Total request body bytes received
364 s_resp_hdrbytes – counter - info
366 Response header bytes
367 Total response header bytes transmitted
369 s_resp_bodybytes – counter - info
371 Response body bytes
372 Total response body bytes transmitted
374 s_pipe_hdrbytes – counter - info
376 Pipe request header bytes
377 Total request bytes received for piped sessions
379 s_pipe_in – counter - info
381 Piped bytes from client
382 Total number of bytes forwarded from clients in pipe sessions
384 s_pipe_out – counter - info
386 Piped bytes to client
387 Total number of bytes forwarded to clients in pipe sessions
389 sess_closed – counter - info
391 Session Closed
392 sess_closed_err – counter - info
394 Session Closed with error
395 Total number of sessions closed with errors. See sc_* diag counters
397 for detailed breakdown
398 sess_readahead – counter - info
400 Session Read Ahead
401 sess_herd – counter - diag
403 Session herd
404 Number of times the timeout_linger triggered
406 sc_rem_close – counter - diag
408 Session OK REM_CLOSE
409 Number of session closes with REM_CLOSE (Client Closed)
411 sc_req_close – counter - diag
413 Session OK REQ_CLOSE
414 Number of session closes with REQ_CLOSE (Client requested close)
416 sc_req_http10 – counter - diag
418 Session Err REQ_HTTP10
419 Number of session closes with Error REQ_HTTP10 (Proto < HTTP/1.1)
421 sc_rx_bad – counter - diag
423 Session Err RX_BAD
424 Number of session closes with Error RX_BAD (Received bad req/resp)
426 sc_rx_body – counter - diag
428 Session Err RX_BODY
429 Number of session closes with Error RX_BODY (Failure receiving
431 req.body)
432 sc_rx_junk – counter - diag
434 Session Err RX_JUNK
435 Number of session closes with Error RX_JUNK (Received junk data)
437 sc_rx_overflow – counter - diag
439 Session Err RX_OVERFLOW
440 Number of session closes with Error RX_OVERFLOW (Received buffer
442 overflow)
443 sc_rx_timeout – counter - diag
445 Session Err RX_TIMEOUT
446 Number of session closes with Error RX_TIMEOUT (Receive timeout)
448 sc_tx_pipe – counter - diag
450 Session OK TX_PIPE
451 Number of session closes with TX_PIPE (Piped transaction)
453 sc_tx_error – counter - diag
455 Session Err TX_ERROR
456 Number of session closes with Error TX_ERROR (Error transaction)
458 sc_tx_eof – counter - diag
460 Session OK TX_EOF
461 Number of session closes with TX_EOF (EOF transmission)
463 sc_resp_close – counter - diag
465 Session OK RESP_CLOSE
466 Number of session closes with RESP_CLOSE (Backend/VCL requested
468 close)
469 sc_overload – counter - diag
471 Session Err OVERLOAD
472 Number of session closes with Error OVERLOAD (Out of some resource)
474 sc_pipe_overflow – counter - diag
476 Session Err PIPE_OVERFLOW
477 Number of session closes with Error PIPE_OVERFLOW (Session pipe
479 overflow)
480 sc_range_short – counter - diag
482 Session Err RANGE_SHORT
483 Number of session closes with Error RANGE_SHORT (Insufficient data
485 for range)
486 sc_req_http20 – counter - diag
488 Session Err REQ_HTTP20
489 Number of session closes with Error REQ_HTTP20 (HTTP2 not accepted)
491 sc_vcl_failure – counter - diag
493 Session Err VCL_FAILURE
494 Number of session closes with Error VCL_FAILURE (VCL failure)
496 client_resp_500 – counter - diag
498 Delivery failed due to insufficient workspace.
499 Number of times we failed a response due to running out of workspace
501 memory during delivery.
502 ws_backend_overflow – counter - diag
504 workspace_backend overflows
505 Number of times we ran out of space in workspace_backend.
507 ws_client_overflow – counter - diag
509 workspace_client overflows
510 Number of times we ran out of space in workspace_client.
512 ws_thread_overflow – counter - diag
514 workspace_thread overflows
515 Number of times we ran out of space in workspace_thread.
517 ws_session_overflow – counter - diag
519 workspace_session overflows
520 Number of times we ran out of space in workspace_session.
522 shm_records – counter - diag
524 SHM records
525 shm_writes – counter - diag
527 SHM writes
528 shm_flushes – counter - diag
530 SHM flushes due to overflow
531 shm_cont – counter - diag
533 SHM MTX contention
534 shm_cycles – counter - diag
536 SHM cycles through buffer
537 backend_req – counter - info
539 Backend requests made
540 n_vcl – gauge - info
542 Number of loaded VCLs in total
543 n_vcl_avail – gauge - diag
545 Number of VCLs available
546 n_vcl_discard – gauge - diag
548 Number of discarded VCLs
549 vcl_fail – counter - info
551 VCL failures
552 Count of failures which prevented VCL from completing.
554 bans – gauge - info
556 Count of bans
557 Number of all bans in system, including bans superseded by newer
559 bans and bans already checked by the ban-lurker.
560 bans_completed – gauge - diag
562 Number of bans marked 'completed'
563 Number of bans which are no longer active, either because they got
565 checked by the ban-lurker or superseded by newer identical bans.
566 bans_obj – gauge - diag
568 Number of bans using obj.*
569 Number of bans which use obj.* variables. These bans can possibly
571 be washed by the ban-lurker.
572 bans_req – gauge - diag
574 Number of bans using req.*
575 Number of bans which use req.* variables. These bans can not be
577 washed by the ban-lurker.
578 bans_added – counter - diag
580 Bans added
581 Counter of bans added to ban list.
583 bans_deleted – counter - diag
585 Bans deleted
586 Counter of bans deleted from ban list.
588 bans_tested – counter - diag
590 Bans tested against objects (lookup)
591 Count of how many bans and objects have been tested against each
593 other during hash lookup.
594 bans_obj_killed – counter - diag
596 Objects killed by bans (lookup)
597 Number of objects killed by bans during object lookup.
599 bans_lurker_tested – counter - diag
601 Bans tested against objects (lurker)
602 Count of how many bans and objects have been tested against each
604 other by the ban-lurker.
605 bans_tests_tested – counter - diag
607 Ban tests tested against objects (lookup)
608 Count of how many tests and objects have been tested against each
610 other during lookup. 'ban req.url == foo && req.http.host == bar'
611 counts as one in 'bans_tested' and as two in 'bans_tests_tested'
612 bans_lurker_tests_tested – counter - diag
614 Ban tests tested against objects (lurker)
615 Count of how many tests and objects have been tested against each
617 other by the ban-lurker. 'ban req.url == foo && req.http.host ==
618 bar' counts as one in 'bans_tested' and as two in
619 'bans_tests_tested'
620 bans_lurker_obj_killed – counter - diag
622 Objects killed by bans (lurker)
623 Number of objects killed by the ban-lurker.
625 bans_lurker_obj_killed_cutoff – counter - diag
627 Objects killed by bans for cutoff (lurker)
628 Number of objects killed by the ban-lurker to keep the number of
630 bans below ban_cutoff.
631 bans_dups – counter - diag
633 Bans superseded by other bans
634 Count of bans replaced by later identical bans.
636 bans_lurker_contention – counter - diag
638 Lurker gave way for lookup
639 Number of times the ban-lurker had to wait for lookups.
641 bans_persisted_bytes – gauge - diag
643 Bytes used by the persisted ban lists
644 Number of bytes used by the persisted ban lists.
646 bans_persisted_fragmentation – gauge - diag
648 Extra bytes in persisted ban lists due to fragmentation
649 Number of extra bytes accumulated through dropped and completed bans
651 in the persistent ban lists.
652 n_purges – counter - info
654 Number of purge operations executed
655 n_obj_purged – counter - info
657 Number of purged objects
658 exp_mailed – counter - diag
660 Number of objects mailed to expiry thread
661 Number of objects mailed to expiry thread for handling.
663 exp_received – counter - diag
665 Number of objects received by expiry thread
666 Number of objects received by expiry thread for handling.
668 hcb_nolock – counter - debug
670 HCB Lookups without lock
671 hcb_lock – counter - debug
673 HCB Lookups with lock
674 hcb_insert – counter - debug
676 HCB Inserts
677 esi_errors – counter - diag
679 ESI parse errors (unlock)
680 esi_warnings – counter - diag
682 ESI parse warnings (unlock)
683 vmods – gauge - info
685 Loaded VMODs
686 n_gzip – counter - info
688 Gzip operations
689 n_gunzip – counter - info
691 Gunzip operations
692 n_test_gunzip – counter - info
694 Test gunzip operations
695 Those operations occur when Varnish receives a compressed object
697 from a backend. They are done to verify the gzip stream while it's
698 inserted in storage.
699
701 uptime – counter - info
702 Management process uptime
703 Uptime in seconds of the management process
705 child_start – counter - diag
707 Child process started
708 Number of times the child process has been started
710 child_exit – counter - diag
712 Child process normal exit
713 Number of times the child process has been cleanly stopped
715 child_stop – counter - diag
717 Child process unexpected exit
718 Number of times the child process has exited with an unexpected
720 return code
721 child_died – counter - diag
723 Child process died (signal)
724 Number of times the child process has died due to signals
726 child_dump – counter - diag
728 Child process core dumped
729 Number of times the child process has produced core dumps
731 child_panic – counter - diag
733 Child process panic
734 Number of times the management process has caught a child panic
736
738 live – gauge - debug
739 In use
740 pool – gauge - debug
742 In Pool
743 sz_wanted – gauge - debug
745 Size requested
746 sz_actual – gauge - debug
748 Size allocated
749 allocs – counter - debug
751 Allocations
752 frees – counter - debug
754 Frees
755 recycle – counter - debug
757 Recycled from pool
758 timeout – counter - debug
760 Timed out from pool
761 toosmall – counter - debug
763 Too small to recycle
764 surplus – counter - debug
766 Too many for pool
767 randry – counter - debug
769 Pool ran dry
770
772 c_req – counter - info
773 Allocator requests
774 Number of times the storage has been asked to provide a storage seg‐
776 ment.
777 c_fail – counter - info
779 Allocator failures
780 Number of times the storage has failed to provide a storage segment.
782 c_bytes – counter - info
784 Bytes allocated
785 Number of total bytes allocated by this storage.
787 c_freed – counter - info
789 Bytes freed
790 Number of total bytes returned to this storage.
792 g_alloc – gauge - info
794 Allocations outstanding
795 Number of storage allocations outstanding.
797 g_bytes – gauge - info
799 Bytes outstanding
800 Number of bytes allocated from the storage.
802 g_space – gauge - info
804 Bytes available
805 Number of bytes left in the storage.
807
809 c_req – counter - info
810 Allocator requests
811 Number of times the storage has been asked to provide a storage seg‐
813 ment.
814 c_fail – counter - info
816 Allocator failures
817 Number of times the storage has failed to provide a storage segment.
819 c_bytes – counter - info
821 Bytes allocated
822 Number of total bytes allocated by this storage.
824 c_freed – counter - info
826 Bytes freed
827 Number of total bytes returned to this storage.
829 g_alloc – gauge - info
831 Allocations outstanding
832 Number of storage allocations outstanding.
834 g_bytes – gauge - info
836 Bytes outstanding
837 Number of bytes allocated from the storage.
839 g_space – gauge - info
841 Bytes available
842 Number of bytes left in the storage.
844
846 c_req – counter - info
847 Allocator requests
848 Number of times the storage has been asked to provide a storage seg‐
850 ment.
851 c_fail – counter - info
853 Allocator failures
854 Number of times the storage has failed to provide a storage segment.
856 c_bytes – counter - info
858 Bytes allocated
859 Number of total bytes allocated by this storage.
861 c_freed – counter - info
863 Bytes freed
864 Number of total bytes returned to this storage.
866 g_alloc – gauge - info
868 Allocations outstanding
869 Number of storage allocations outstanding.
871 g_bytes – gauge - info
873 Bytes outstanding
874 Number of bytes allocated from the storage.
876 g_space – gauge - info
878 Bytes available
879 Number of bytes left in the storage.
881 g_smf – gauge - info
883 N struct smf
884 g_smf_frag – gauge - info
886 N small free smf
887 g_smf_large – gauge - info
889 N large free smf
890
892 happy – bitmap - info
893 Happy health probes
894 bereq_hdrbytes – counter - info
896 Request header bytes
897 Total backend request header bytes sent
899 bereq_bodybytes – counter - info
901 Request body bytes
902 Total backend request body bytes sent
904 beresp_hdrbytes – counter - info
906 Response header bytes
907 Total backend response header bytes received
909 beresp_bodybytes – counter - info
911 Response body bytes
912 Total backend response body bytes received
914 pipe_hdrbytes – counter - info
916 Pipe request header bytes
917 Total request bytes sent for piped sessions
919 pipe_out – counter - info
921 Piped bytes to backend
922 Total number of bytes forwarded to backend in pipe sessions
924 pipe_in – counter - info
926 Piped bytes from backend
927 Total number of bytes forwarded from backend in pipe sessions
929 conn – gauge - info
931 Concurrent connections to backend
932 req – counter - info
934 Backend requests sent
935 unhealthy – counter - info
937 Fetches not attempted due to backend being unhealthy
938 busy – counter - info
940 Fetches not attempted due to backend being busy
941 Number of times the max_connections limit was reached
943 fail – counter - info
945 Connections failed
946 Counter of failed opens. Detailed reasons are given in the fail_*
948 counters (DIAG level) and in Debug VSL.
949 This counter is the sum of all detailed fail_* counters.
951 All fail_* counters may be slightly inaccurate for efficiency.
953 fail_eacces – counter - diag
955 Connections failed with EACCES or EPERM
956 fail_eaddrnotavail – counter - diag
958 Connections failed with EADDRNOTAVAIL
959 fail_econnrefused – counter - diag
961 Connections failed with ECONNREFUSED
962 fail_enetunreach – counter - diag
964 Connections failed with ENETUNREACH
965 fail_etimedout – counter - diag
967 Connections failed ETIMEDOUT
968 fail_other – counter - diag
970 Connections failed for other reason
971 helddown – counter - diag
973 Connection opens not attempted
974 Connections not attempted during the backend_local_error_holddown or
976 backend_remote_error_holddown interval after a fundamental connec‐
977 tion issue.
978
980 Counters which track the activity in the different classes of
981 mutex-locks.
982 The counts may be slightly wrong if there are more than one lock
984 instantiated in each class (ie: .creat > 1)
985 creat – counter - debug
987 Created locks
988 destroy – counter - debug
990 Destroyed locks
991 locks – counter - debug
993 Lock Operations
994
996 This man page was written by Lasse Karstensen, using content from
997 vsc2rst written by Tollef Fog Heen.
998 VARNISH-COUNTERS(7)