VARNISHLOG(1) VARNISHLOG(1)
NAME
varnishlog - Display Varnish logs
SYNOPSIS
varnishlog [-a] [-b] [-C] [-c] [-D] [-d] [-I regex] [-i tag] [-k keep] [-n varnish_name] [-o] [-O] [-m tag:regex ...] [-P file] [-r file]
[-s num] [-u] [-V] [-w file] [-X regex] [-x tag]
DESCRIPTION
The varnishlog utility reads and presents varnishd(1) shared memory logs.
The following options are available:
-a When writing to a file, append to it rather than overwrite it.
-b Include log entries which result from communication with a backend server. If neither -b nor -c is specified, varnishlog acts as if
they both were.
-C Ignore case when matching regular expressions.
-c Include log entries which result from communication with a client. If neither -b nor -c is specified, varnishlog acts as if they
both were.
-D Daemonize.
-d Process old log entries on startup. Normally, varnishlog will only process entries which are written to the log after it starts.
-I regex
Include log entries which match the specified regular expression. If neither -I nor -i is specified, all log entries are included.
-i tag Include log entries with the specified tag. If neither -I nor -i is specified, all log entries are included.
-k num Only show the first num log records.
-m tag:regex only list transactions where tag matches regex. Multiple
-m options are AND-ed together. Can not be combined with -O
-n Specifies the name of the varnishd instance to get logs from. If -n is not specified, the host name is used.
-o Ignored for compatibility with earlier versions.
-O Do not group log entries by request ID. Can not be combined with -m.
-P file
Write the process's PID to the specified file.
-r file
Read log entries from file instead of shared memory.
-s num Skip the first num log records.
-u Unbuffered output.
-V Display the version number and exit.
-w file
Write log entries to file instead of displaying them. The file will be overwritten unless the -a option was specified. If var-
nishlog receives a SIGHUP while writing to a file, it will reopen the file, allowing the old one to be rotated away.
-X regex
Exclude log entries which match the specified regular expression.
-x tag Exclude log entries with the specified tag.
TAGS
The following log entry tags are currently defined:
o Backend
o BackendClose
o BackendOpen
o BackendReuse
o BackendXID
o CLI
o ClientAddr
o Debug
o Error
o ExpBan
o ExpKill
o ExpPick
o Hit
o HitPass
o HttpError
o HttpGarbage
o Length
o ObjHeader
o ObjLostHeader
o ObjProtocol
o ObjRequest
o ObjResponse
o ObjStatus
o ObjURL
o ReqEnd
o ReqStart
o RxHeader
o RxLostHeader
o RxProtocol
o RxRequest
o RxResponse
o RxStatus
o RxURL
o SessionClose
o SessionOpen
o StatAddr
o StatSess
o TTL
o TxHeader
o TxLostHeader
o TxProtocol
o TxRequest
o TxResponse
o TxStatus
o TxURL
o VCL_acl
o VCL_call
o VCL_return
o VCL_trace
o WorkThread
EXAMPLES
The following command line simply copies all log entries to a log file::
$ varnishlog -w /var/log/varnish.log
The following command line reads that same log file and displays requests for the front page::
$ varnishlog -r /var/log/varnish.log -c -m 'RxURL:^/$'
SEE ALSO
o varnishd(1)
o varnishhist(1)
o varnishncsa(1)
o varnishstat(1)
o varnishtop(1)
HISTORY
The varnishlog utility was developed by Poul-Henning Kamp <phk@phk.freebsd.dk> in cooperation with Verdens Gang AS, Varnish Software AS and
Varnish Software. This manual page was initially written by Dag-Erling Smorgrav.
COPYRIGHT
This document is licensed under the same licence as Varnish itself. See LICENCE for details.
o Copyright (c) 2006 Verdens Gang AS
o Copyright (c) 2006-2011 Varnish Software AS
AUTHOR
Dag-Erling Smorgrav, Per Buer
0.2 2010-05-31 VARNISHLOG(1)