Provided by: varnish_3.0.5-2ubuntu0.1_amd64
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 varnishlog 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: • 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 Software 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