← Back to branch summary

~ubuntu-branches/debian/sid/varnish/sid

« back to all changes in this revision

Viewing changes to doc/sphinx/=build/html/_sources/reference/varnishhist.txt

  • Committer: Package Import Robot
  • Author(s): Stig Sandbeck Mathisen
  • Date: 2011-10-29 15:23:24 UTC
  • mfrom: (0.1.15)
  • Revision ID: package-import@ubuntu.com-20111029152324-tdtlsurrv22ysknj
Tags: 3.0.2-1
* New upstream release
* Build from upstream tarball instead of git tag
* debian/watch: more specific regular expression

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/sphinx/=build/html/_sources/reference/varnishhist.txt
 
1
===========
 
2
varnishhist
 
3
===========
 
4
 
 
5
-------------------------
 
6
Varnish request histogram
 
7
-------------------------
 
8
 
 
9
:Author: Dag-Erling Smørgrav
 
10
:Date:   2010-05-31
 
11
:Version: 1.0
 
12
:Manual section: 1
 
13
 
 
14
 
 
15
SYNOPSIS
 
16
========
 
17
 
 
18
varnishhist [-b] [-C] [-c] [-d] [-I regex] [-i tag] [-m tag:regex ...] 
 
19
[-n varnish_name] [-r file] [-V] [-w delay] [-X regex] [-x tag]
 
20
 
 
21
DESCRIPTION
 
22
===========
 
23
 
 
24
The varnishhist utility reads varnishd(1) shared memory logs and
 
25
presents a continuously updated histogram show‐ ing the distribution
 
26
of the last N requests by their processing.  The value of N and the
 
27
vertical scale are dis‐ played in the top left corner.  The horizontal
 
28
scale is logarithmic.  Hits are marked with a pipe character ("|"),
 
29
and misses are marked with a hash character ("#").
 
30
 
 
31
The following options are available:
 
32
 
 
33
-b          Include log entries which result from communication with 
 
34
            a backend server.  If neither -b nor -c is
 
35
            specified, varnishhist acts as if they both were.
 
36
 
 
37
-C          Ignore case when matching regular expressions.
 
38
 
 
39
-c          Include log entries which result from communication with 
 
40
            a client.  If neither -b nor -c is specified, 
 
41
            varnishhist acts as if they both were.
 
42
 
 
43
-d          Process old log entries on startup.  Normally, varnishhist 
 
44
            will only process entries which are written to the 
 
45
            log after it starts.
 
46
 
 
47
-I regex    Include log entries which match the specified 
 
48
            regular expression.  If neither -I nor -i is specified, 
 
49
            all log entries are included.
 
50
 
 
51
-i tag      Include log entries with the specified tag.  If neither 
 
52
            -I nor -i is specified, all log entries are included.
 
53
 
 
54
-m tag:regex only count transactions where tag matches regex. Multiple
 
55
            -m options are AND-ed together.
 
56
 
 
57
-n          Specifies the name of the varnishd instance to get logs 
 
58
            from.  If -n is not specified, the host name is used.
 
59
 
 
60
-r file     Read log entries from file instead of shared memory.
 
61
 
 
62
-V          Display the version number and exit.
 
63
 
 
64
-w delay    Wait at least delay seconds between each update.  The 
 
65
            default is 1.  file instead of displaying them.  The file 
 
66
            will be overwritten unless the -a option was specified.
 
67
 
 
68
-X regex    Exclude log entries which match the specified regular expression.
 
69
 
 
70
-x tag      Exclude log entries with the specified tag.
 
71
 
 
72
SEE ALSO
 
73
========
 
74
 
 
75
* varnishd(1)
 
76
* varnishlog(1)
 
77
* varnishncsa(1)
 
78
* varnishstat(1) 
 
79
* varnishtop(1)
 
80
 
 
81
HISTORY
 
82
=======
 
83
The varnishhist utility was developed by Poul-Henning Kamp in cooperation with Verdens Gang
 
84
AS and Varnish Software AS.  This manual page was written by Dag-Erling Smørgrav.
 
85
 
 
86
COPYRIGHT
 
87
=========
 
88
 
 
89
This document is licensed under the same licence as Varnish
 
90
itself. See LICENCE for details.
 
91
 
 
92
* Copyright (c) 2006 Verdens Gang AS
 
93
* Copyright (c) 2006-2011 Varnish Software AS