NAME¶
varnishhist - Varnish request histogram
SYNOPSIS¶
varnishhist [-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 vertical 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
backend 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
expression. 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
overwritten unless the -a option was specified.
- -X regex
- Exclude log entries which match the specified regular
expression.
- -x tag
- Exclude log entries with the specified tag.
SEE ALSO¶
HISTORY¶
The varnishhist utility was developed by Poul-Henning Kamp in cooperation 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