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)