VARNISHLOG(1)VARNISHLOG(1)NAMEvarnishlog - Display Varnish logs
SYNOPSISvarnishlog [-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 back‐
end 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 expres‐
sion. 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 expres‐
sion.
-x tag Exclude log entries with the specified tag.
TAGS
The following log entry tags are currently defined:
· Backend
· BackendClose
· BackendOpen
· BackendReuse
· BackendXID
· CLI
· ClientAddr
· Debug
· Error
· ExpBan
· ExpKill
· ExpPick
· Hit
· HitPass
· HttpError
· HttpGarbage
· Length
· ObjHeader
· ObjLostHeader
· ObjProtocol
· ObjRequest
· ObjResponse
· ObjStatus
· ObjURL
· ReqEnd
· ReqStart
· RxHeader
· RxLostHeader
· RxProtocol
· RxRequest
· RxResponse
· RxStatus
· RxURL
· SessionClose
· SessionOpen
· StatAddr
· StatSess
· TTL
· TxHeader
· TxLostHeader
· TxProtocol
· TxRequest
· TxResponse
· TxStatus
· TxURL
· VCL_acl
· VCL_call
· VCL_return
· VCL_trace
· 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
· varnishd(1)
· varnishhist(1)
· varnishncsa(1)
· varnishstat(1)
· varnishtop(1)HISTORY
The varnishlog utility was developed by Poul-Henning Kamp
⟨phk@phk.freebsd.dk⟩ in cooperation with Verdens Gang AS, Varnish Soft‐
ware AS and Varnish Software. This manual page was initially written
by Dag-Erling Smørgrav.
COPYRIGHT
This document is licensed under the same licence as Varnish itself. See
LICENCE for details.
· Copyright (c) 2006 Verdens Gang AS
· Copyright (c) 2006-2011 Varnish Software AS
AUTHOR
Dag-Erling Smørgrav, Per Buer
0.2 2010-05-31 VARNISHLOG(1)