VARNISHHIST(1)VARNISHHIST(1)NAMEvarnishhist - Varnish request histogram
SYNOPSISvarnishhist [-b] [-C] [-c] [-d] [-I regex] [-i tag] [-m tag:regex ...]
[-n varnish_name] [-r file] [-V] [-w delay] [-X regex] [-x tag]
DESCRIPTION
The varnishhist utility reads varnishd(1) shared memory logs and
presents a continuously updated histogram show‐ ing the distribution of
the last N requests by their processing. The value of N and the verti‐
cal scale are dis‐ played in the top left corner. The horizontal scale
is logarithmic. Hits are marked with a pipe character ("|"), and
misses are marked with a hash character ("#").
The following options are available:
-b Include log entries which result from communication with a back‐
end server. If neither -b nor -c is specified, varnishhist acts
as if they both were.
-C Ignore case when matching regular expressions.
-c Include log entries which result from communication with a
client. If neither -b nor -c is specified, varnishhist acts as
if they both were.
-d Process old log entries on startup. Normally, varnishhist will
only process entries which are written to the log after it
starts.
-I regex
Include log entries which match the specified regular expres‐
sion. If neither -I nor -i is specified, all log entries are
included.
-i tag Include log entries with the specified tag. If neither -I nor
-i is specified, all log entries are included.
-m tag:regex only count transactions where tag matches regex. Multiple
-m options are AND-ed together.
-n Specifies the name of the varnishd instance to get logs from.
If -n is not specified, the host name is used.
-r file
Read log entries from file instead of shared memory.
-V Display the version number and exit.
-w delay
Wait at least delay seconds between each update. The default is
1. file instead of displaying them. The file will be overwrit‐
ten unless the -a option was specified.
-X regex
Exclude log entries which match the specified regular expres‐
sion.
-x tag Exclude log entries with the specified tag.
SEE ALSO
· varnishd(1)
· varnishlog(1)
· varnishncsa(1)
· varnishstat(1)
· varnishtop(1)HISTORY
The varnishhist utility was developed by Poul-Henning Kamp in coopera‐
tion with Verdens Gang AS and Varnish Software AS. This manual page
was written by Dag-Erling Smørgrav.
COPYRIGHT
This document is licensed under the same licence as Varnish itself. See
LICENCE for details.
· Copyright (c) 2006 Verdens Gang AS
· Copyright (c) 2006-2011 Varnish Software AS
AUTHOR
Dag-Erling Smørgrav
1.0 2010-05-31 VARNISHHIST(1)
