Provided by: varnish_3.0.2-1_amd64 bug

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