VARNISHSTAT()VARNISHSTAT()NAME
varnishstat - Varnish Cache statistics
SYNOPSIS
varnishstat [-1] [-x] [-j] [-f field_list] [-l] [-n varnish_name] [-N
filename] [-V] [-w delay]
DESCRIPTION
The varnishstat utility displays statistics from a running varnishd(1)
instance.
OPTIONS
The following options are available:
-1 Instead of presenting a continuously updated display, print the
statistics to stdout.
-f Field inclusion glob. A field glob consists of three parts,
type, ident and name, where ident is optional. Each part can
contain a '*' character at the end to match a prefix. Use back‐
slash to escape characters. If the argument starts with '^' it
is used as an exclusion glob. Multiple -f arguments may be
given, and they will be applied in order.
-l Lists the available fields to use with the -f option.
-n Specifies the name of the varnishd instance to get logs from.
If -n is not specified, the host name is used.
-N Specify a the filename of a stale VSM instance. When using this
option the abandonment checking is disabled.
-V Display the version number and exit.
-w delay
Wait delay seconds between updates. The default is 1. Can also
be used with -1, -x or -j for repeated output.
-x Displays the result as XML.
-j Displays the result as JSON.
CURSES MODE
When neither -1, -j or -x options are given, the application starts up
in curses mode. This shows a continously 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.
Columns
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 Var‐
nish 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.
Key bindings
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.
<g> Go to the top of the counter list.
<G> Go to the bottom of the counter list.
<d> Toggle between showing and hiding unseen counters. Unseen coun‐
ters are those that has been zero for the entire runtime of var‐
nishstat. Defaults to hide unseen counters.
<v> Cycle through the verbosity levels. Defaults to only showing
informational counters.
<q> Quit.
<CTRL+T>
Sample now.
XML OUTPUT
When using the -x option, the output is:
<stat>
<name>FIELD NAME</name>
<value>FIELD VALUE</value>
<description>FIELD DESCRIPTION</description>
</stat>
JSON OUTPUT
With -j the output format is:
{
"timestamp": "YYYY-MM-DDTHH:mm:SS",
"client_conn": {
"value": 0, "flag": "a",
"description": "Client connections accepted"
},
"client_drop": {
"value": 0, "flag": "a",
"description": "Connection dropped, no sess/wrk"
},
"LCK.backend.creat": {
"type": "LCK", "ident": "backend", "value": 1,
"flag": "a", "description": "Created locks"
},
[..]
}
Timestamp is the time when the report was generated by varnishstat.
Repeated output with -1, -x or -j will have a single empty line (\n)
between each block of output.
SEE ALSO
· varnishd(1)
· varnishhist(1)
· varnishlog(1)
· varnishncsa(1)
· varnishtop(1)
· curses(3)HISTORY
The varnishstat utility was originally developed by Poul-Henning Kamp
<phk@phk.freebsd.dk> in cooperation with Verdens Gang AS and Varnish
Software AS. Manual page written by Dag-Erling Smørgrav, Per Buer,
Lasse Karstensen and Martin Blix Grydeland.
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-2014 Varnish Software AS
VARNISHSTAT()