1VARNISHHIST(1)                                                  VARNISHHIST(1)
2
3
4

NAME

6       varnishhist - Varnish request histogram
7

SYNOPSIS

9       varnishhist  [-b]  [-C] [-c] [-d] [-I regex] [-i tag] [-n varnish_name]
10       [-r file] [-V] [-w delay] [-X regex] [-x tag]
11

DESCRIPTION

13       The varnishhist  utility  reads  varnishd(1)  shared  memory  logs  and
14       presents a continuously updated histogram show‐ ing the distribution of
15       the last N requests by their processing.  The value of N and the verti‐
16       cal scale are dis‐ played in the top left corner.  The horizontal scale
17       is logarithmic.  Hits are marked  with  a  pipe  character  ("|"),  and
18       misses are marked with a hash character ("#").
19
20       The following options are available:
21
22       -b     Include log entries which result from communication with a back‐
23              end server.  If neither -b nor -c is specified, varnishhist acts
24              as if they both were.
25
26       -C     Ignore case when matching regular expressions.
27
28       -c     Include  log  entries  which  result  from  communication with a
29              client.  If neither -b nor -c is specified, varnishhist acts  as
30              if they both were.
31
32       -d     Process  old log entries on startup.  Normally, varnishhist will
33              only process entries which are  written  to  the  log  after  it
34              starts.
35
36       -I regex
37              Include  log  entries  which match the specified regular expres‐
38              sion.  If neither -I nor -i is specified, all  log  entries  are
39              included.
40
41       -i tag Include  log  entries with the specified tag.  If neither -I nor
42              -i is specified, all log entries are included.
43
44       -n     Specifies the name of the varnishd instance to  get  logs  from.
45              If -n is not specified, the host name is used.
46
47       -r file
48              Read log entries from file instead of shared memory.
49
50       -V     Display the version number and exit.
51
52       -w delay
53              Wait at least delay seconds between each update.  The default is
54              1.  file instead of displaying them.  The file will be overwrit‐
55              ten unless the -a option was specified.
56
57       -X regex
58              Exclude  log  entries  which match the specified regular expres‐
59              sion.
60
61       -x tag Exclude log entries with the specified tag.
62

SEE ALSO

64       · varnishd(1)
65
66       · varnishlog(1)
67
68       · varnishncsa(1)
69
70       · varnishstat(1)
71
72       · varnishtop(1)
73

HISTORY

75       The varnishhist utility was developed by Poul-Henning Kamp in  coopera‐
76       tion  with Verdens Gang AS and Linpro AS.  This manual page was written
77       by Dag-Erling Smørgrav.
78

80       This document is licensed under the same licence as Varnish itself. See
81       LICENCE for details.
82
83       · Copyright (c) 2006 Verdens Gang AS
84
85       · Copyright (c) 2006-2008 Linpro AS
86
87       · Copyright (c) 2008-2010 Redpill Linpro AS
88
89       · Copyright (c) 2010 Varnish Software AS
90

AUTHOR

92       Dag-Erling Smørgrav
93
94
95
96
971.0                               2010-05-31                    VARNISHHIST(1)
Impressum