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]
DESCRIPTIONThe 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. If the -o option was specified, an additional tag and regex may be specified to select only requests which generated a log entry with the given tag whose contents match the given regex.
TAGSThe 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
EXAMPLESThe 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 -o RxURL '^/$'
SEE ALSOo varnishd(1) o varnishhist(1) o varnishncsa(1) o varnishstat(1) o varnishtop(1)
HISTORYThe varnishlog utility was developed by Poul-Henning Kamp <firstname.lastname@example.org> in cooperation with Verdens Gang AS, Varnish Software AS and Varnish Software. This manual page was initially written by Dag-Erling Smorgrav.
COPYRIGHTThis 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
AUTHORDag-Erling Smorgrav, Per Buer VARNISHLOG(1)