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.
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¶
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