[master] 8bc97703d vsc: Add a long description to MAIN.shm_* counters

Dridi Boukelmoune dridi.boukelmoune at gmail.com
Fri Aug 5 09:16:05 UTC 2022


commit 8bc97703d03e5e277b5d0cbbaa800512f3a44675
Author: Dridi Boukelmoune <dridi.boukelmoune at gmail.com>
Date:   Mon Jul 18 08:26:32 2022 +0200

    vsc: Add a long description to MAIN.shm_* counters

diff --git a/lib/libvsc/VSC_main.vsc b/lib/libvsc/VSC_main.vsc
index 7b32584c9..87bf4933b 100644
--- a/lib/libvsc/VSC_main.vsc
+++ b/lib/libvsc/VSC_main.vsc
@@ -670,25 +670,37 @@
 	:level:	diag
 	:oneliner:	SHM records
 
+	Number of log records written to the shared memory log.
+
 
 .. varnish_vsc:: shm_writes
 	:level:	diag
 	:oneliner:	SHM writes
 
+	Number of individual writes to the shared memory log. A single
+	write may batch multiple records for bufferred tasks.
+
 
 .. varnish_vsc:: shm_flushes
 	:level:	diag
 	:oneliner:	SHM flushes due to overflow
 
+	Number of writes performed before the end of a bufferred task
+	because adding a record to a batch would exceed vsl_buffer.
 
 .. varnish_vsc:: shm_cont
 	:level:	diag
-	:oneliner:	SHM MTX contention
+	:oneliner:	SHM lock contention
+
+	Number of times a write had to wait for the lock.
 
 
 .. varnish_vsc:: shm_cycles
 	:level:	diag
-	:oneliner:	SHM cycles through buffer
+	:oneliner:	SHM cycles through VSL space
+
+	Number of times a write of log records would reach past the end
+	of the shared memory log, cycling back to the beginning.
 
 
 .. varnish_vsc:: backend_req


More information about the varnish-commit mailing list