| Author: | Dag-Erling Smørgrav |
|---|---|
| Author: | Per Buer |
| Author: | Lasse Karstensen |
| Date: | 2011-11-07 |
| Version: | 1.1 |
| Manual section: | 1 |
varnishstat [-1] [-x] [-j] [-f field_list] [-l] [-n varnish_name] [-V] [-w delay]
The varnishstat utility displays statistics from a running varnishd(1) instance.
The following options are available:
| -1 | Instead of presenting of a continuously updated display, print the statistics to stdout. |
| -f | A comma separated list of the fields to display. If it starts with '^' it is used as an exclusion list. |
| -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. |
| -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. |
The columns in the main display are, from left to right:
When using the -1 option, the columns in the output are, from left to right:
When using the -x option, the output is:
<stat>
<name>FIELD NAME</name>
<value>FIELD VALUE</value>
<description>FIELD DESCRIPTION</description>
</stat>
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.
The varnishstat utility was originally developed by Poul-Henning Kamp ⟨phk@phk.freebsd.dk⟩ in cooperation with Verdens Gang AS, Varnish Software AS and Varnish Software. Manual page written by Dag-Erling Smørgrav, and Per Buer.
This document is licensed under the same licence as Varnish itself. See LICENCE for details.