File: varnishstat.rst

package info (click to toggle)
varnish 7.7.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 13,256 kB
  • sloc: ansic: 104,222; python: 2,679; makefile: 1,303; sh: 1,077; awk: 114; perl: 105; ruby: 41
file content (136 lines) | stat: -rw-r--r-- 2,770 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
..
	Copyright (c) 2010-2020 Varnish Software AS
	SPDX-License-Identifier: BSD-2-Clause
	See LICENSE file for full text of license

.. role:: ref(emphasis)

.. _varnishstat(1):

===========
varnishstat
===========

------------------------
Varnish Cache statistics
------------------------

:Manual section: 1

SYNOPSIS
========

.. include:: ../include/varnishstat_synopsis.rst
varnishstat |synopsis|

DESCRIPTION
===========

The varnishstat utility displays statistics from a running varnishd(1) instance.

The following options are available:

.. include:: ../include/varnishstat_options.rst

CURSES MODE
===========

When neither -1, -j nor -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.

On startup, only counters at INFO level are shown.

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
	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.

Key bindings
------------

.. include:: ../include/varnishstat_bindings.rst

OUTPUTS
=======

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.


SEE ALSO
========

* :ref:`varnishd(1)`
* :ref:`varnishhist(1)`
* :ref:`varnishlog(1)`
* :ref:`varnishncsa(1)`
* :ref:`varnishtop(1)`
* curses(3)
* :ref:`varnish-counters(7)`


AUTHORS
=======

This manual page was written by Dag-Erling Smørgrav, Per Buer,
Lasse Karstensen and Martin Blix Grydeland.