1VARNISHTOP(1)                                                    VARNISHTOP(1)
2
3
4

NAME

6       varnishtop - Varnish log entry ranking
7

SYNOPSIS

9       varnishtop  [-1]  [-b] [-C] [-c] [-d] [-f] [-I regex] [-i tag] [-n var‐
10       nish_name] [-r file] [-V] [-X regex] [-x tag]
11

DESCRIPTION

13       The  varnishtop  utility  reads  varnishd(1)  shared  memory  logs  and
14       presents a continuously updated list of the most commonly occurring log
15       entries.  With suitable filtering using the -I, -i, -X and -x  options,
16       it  can  be  used to display a ranking of requested documents, clients,
17       user agents, or any other information which is recorded in the log.
18
19       The following options are available:
20
21       -1     Instead of presenting of a continuously updated  display,  print
22              the statistics once and exit. Implies -d.
23
24       -b     Include log entries which result from communication with a back‐
25              end server.  If neither -b nor -c is specified, varnishtop  acts
26              as if they both were.
27
28       -C     Ignore case when matching regular expressions.
29
30       -c     Include  log  entries  which  result  from  communication with a
31              client.  If neither -b nor -c is specified, varnishtop  acts  as
32              if they both were.
33
34       -d     Process  old  log entries on startup.  Normally, varnishtop will
35              only process entries which are  written  to  the  log  after  it
36              starts.
37
38       -f     Sort  and group only on the first field of each log entry.  This
39              is useful when displaying e.g. stataddr entries, where the first
40              field is the client IP address.
41
42       -I regex
43              Include  log  entries  which match the specified regular expres‐
44              sion.  If neither -I nor -i is specified, all  log  entries  are
45              included.
46
47       -i tag Include  log  entries with the specified tag.  If neither -I nor
48              -i is specified, all log entries are included.
49
50       -n     Specifies the name of the varnishd instance to  get  logs  from.
51              If -n is not specified, the host name is used.
52
53       -r file
54              Read log entries from file instead of shared memory.
55
56       -V     Display the version number and exit.
57
58       -X regex
59              Exclude  log  entries  which match the specified regular expres‐
60              sion.
61
62       -x tag Exclude log entries with the specified tag.
63

EXAMPLES

65       The following example displays a continuously updated list of the  most
66       frequently requested URLs::
67
68       varnishtop -i RxURL
69
70       The  following example displays a continuously updated list of the most
71       commonly used user agents::
72
73       varnishtop -i RxHeader -C -I ^User-Agent
74

SEE ALSO

76       · varnishd(1)
77
78       · varnishhist(1)
79
80       · varnishlog(1)
81
82       · varnishncsa(1)
83
84       · varnishstat(1)
85

HISTORY

87       The varnishtop utility was originally developed by Poul-Henning Kamp in
88       cooperation with Verdens Gang AS and Linpro AS, and later substantially
89       rewritten by Dag-Erling Smørgrav.  This  manual  page  was  written  by
90       Dag-Erling Smørgrav.
91

93       This document is licensed under the same licence as Varnish itself. See
94       LICENCE for details.
95
96       · Copyright (c) 2006 Verdens Gang AS
97
98       · Copyright (c) 2006-2008 Linpro AS
99
100       · Copyright (c) 2008-2010 Redpill Linpro AS
101
102       · Copyright (c) 2010 Varnish Software AS
103

AUTHOR

105       Dag-Erling Smørgrav
106
107
108
109
1101.0                               2010-05-31                     VARNISHTOP(1)
Impressum