varnishstat - Varnish Cache statistics
varnishstat [-1] [-f <glob>] [-h] [-j] [-l] [-n <dir>] [-t
<seconds|off>] [-V] [-x]
The varnishstat utility displays statistics from a running varnishd(1) instance.
The following options are available:
- -1
- Instead of presenting a continuously updated display, print the statistics
to stdout.
- -f <glob>
- Field inclusion glob. Use backslash to escape characters. If the argument
starts with '^' it is used as an exclusive glob. Multiple -f arguments may
be given. Inclusive globs are accumulative and are run before exclusive
ones.
- -h
- Print program usage and exit
- -j
- Print statistics to stdout as JSON.
- -l
- Lists the available fields to use with the -f option.
- -n <dir>
- Specify the varnishd working directory (also known as instance name) to
get logs from. If -n is not specified, the host name is used.
- -t <seconds|off>
- Timeout before returning error on initial VSM connection. If set the VSM
connection is retried every 0.5 seconds for this many seconds. If zero the
connection is attempted only once and will fail immediately if
unsuccessful. If set to "off", the connection will not fail,
allowing the utility to start and wait indefinetely for the Varnish
instance to appear. Defaults to 5 seconds.
- -V
- Print version information and exit.
- -x
- Print statistics to stdout as XML.
- --optstring
- Print the optstring parameter to getopt(3) to help writing wrapper
scripts.
When neither -1, -j or -x options are given, the application starts up in curses
mode. This shows a continuously updated view of the counter values, along with
their description.
The top area shows process uptime information.
The center area shows a list of counter values.
The bottom area shows the description of the currently selected counter.
The following columns are displayed, from left to right:
- Name
- The name of the counter
- Current
- The current value of the counter.
- Change
- The average per second change over the last update interval.
- Average
- The average value of this counter over the runtime of the Varnish daemon,
or a period if the counter can't be averaged.
- Avg_10
- The moving average over the last 10 update intervals.
- Avg_100
- The moving average over the last 100 update intervals.
- Avg_1000
- The moving average over the last 1000 update intervals.
The following keys control the interactive display:
- <UP>
- Navigate the counter list one line up.
- <DOWN>
- Navigate the counter list one line down.
- <PAGEUP> or <b>
- Navigate the counter list one page up.
- <PAGEDOWN> or <SPACE>
- Navigate the counter list one page down.
- <d>
- Toggle between showing and hiding unseen counters. Unseen counters are
those that has been zero for the entire runtime of varnishstat. Defaults
to hide unseen counters.
- <e>
- Toggle scaling of values.
- <g>
- Go to the top of the counter list.
- <G>
- Go to the bottom of the counter list.
- <v>
- Cycle through the verbosity levels. Defaults to only showing informational
counters.
- <q>
- Quit.
- <CTRL+T>
- Sample now.
The XML output format is:
<varnishstat timestamp="YYYY-MM-DDTHH:mm:SS">
<stat>
<name>FIELD NAME</name>
<value>FIELD VALUE</value>
<flag>FIELD SEMANTICS</flag>
<format>FIELD DISPLAY FORMAT</format>
<description>FIELD DESCRIPTION</description>
</stat>
[..]
</varnishstat>
The JSON output format is:
{
"timestamp": "YYYY-MM-DDTHH:mm:SS",
"FIELD NAME": {
"description": "FIELD DESCRIPTION",
"flag": "FIELD SEMANTICS", "format": "FIELD DISPLAY FORMAT",
"value": FIELD VALUE
},
"FIELD NAME": {
"description": "FIELD DESCRIPTION",
"flag": "FIELD SEMANTICS", "format": "FIELD DISPLAY FORMAT",
"value": FIELD VALUE
},
[..]
}
Timestamp is the time when the report was generated by varnishstat.
- •
- varnishd(1)
- •
- varnishhist(1)
- •
- varnishlog(1)
- •
- varnishncsa(1)
- •
- varnishtop(1)
- •
- curses(3)
- •
- varnish-counters(7)
This manual page was written by Dag-Erling Smørgrav, Per Buer, Lasse
Karstensen and Martin Blix Grydeland.