NAME¶
varnishlog - Display Varnish logs
SYNOPSIS¶
varnishlog [-a] [-b] [-B] [-c] [-C] [-d] [-D] [-g
<session|request|vxid|raw>] [-h] [-i taglist] [-k num] [-I
<[taglist:]regex>] [-L limit] [-n name] [-N filename] [-P file] [-q
query] [-r filename] [-T seconds] [-v] [-V] [-w filename] [-x taglist] [-X
<[taglist:]regex>] <query expression>
OPTIONS¶
The following options are available:
- -a
- When writing output to a file, append to it rather than overwrite it.
- -b
- Only display transactions and log records coming from backend
communication.
- -B
- Output binary data suitable for reading with -r.
- -c
- Only display transactions and log records coming from client
communication.
- -C
- Do all regular expression and string matching caseless.
- -d
- Start processing log records at the head of the log instead of the
tail.
- -D
- Daemonize.
- -g <session|request|vxid|raw>
- The grouping of the log records. The default is to group by vxid.
- -h
- Print program usage and exit
- -i taglist
- Include log records of these tags in output. Taglist is a comma-separated
list of tag globs. Multiple -i options may be given.
If a tag include option is the first of any tag selection options, all tags
are first marked excluded.
- -k num
- Process this number of matching log transactions before exiting.
- -I <[taglist:]regex>
- Include by regex matching. Output only records matching taglist and
regular expression. Applies to any tag if taglist is absent.
If a tag include option is the first of any tag selection options, all tags
are first marked excluded.
- -L limit
- Sets the upper limit of incomplete transactions kept before the oldest
transaction is force completed. A warning record is synthesized when this
happens. This setting keeps an upper bound on the memory usage of running
queries. Defaults to 1000 transactions.
- -n name
- Specify the name of the varnishd instance to get logs from. If -n is not
specified, the host name is used.
- -N filename
- Specify the filename of a stale VSM instance. When using this option the
abandonment checking is disabled.
- -P file
- Write the process' PID to the specified file.
- -q query
- Specifies the VSL query to use.
- -r filename
- Read log in binary file format from this file.
- -T seconds
- Sets the transaction timeout in seconds. This defines the maximum number
of seconds elapsed between a Begin tag and the End tag. If the timeout
expires, a warning record is synthesized and the transaction is force
completed. Defaults to 120 seconds.
- -v
- Use verbose output on record set printing, giving the VXID on every log
line. Without this option, the VXID will only be given on the header of
that transaction.
- -V
- Print version information and exit.
- -w filename
- Redirect output to file. The file will be overwritten unless the -a option
was specified. If the application receives a SIGHUP the file will be
reopened allowing the old one to be rotated away.
- -x taglist
- Exclude log records of these tags in output. Taglist is a comma-separated
list of tag globs. Multiple -x options may be given.
- -X <[taglist:]regex>
- Exclude by regex matching. Do not output records matching taglist and
regular expression. Applies to any tag if taglist is absent.
SIGNALS¶
- •
- SIGHUP
Rotate the log file (see -w option)
- •
- SIGUSR1
Flush any outstanding transactions
SEE ALSO¶
HISTORY¶
The varnishlog utility was developed by Poul-Henning Kamp <
phk@phk.freebsd.dk> in cooperation with Verdens Gang AS and Varnish
Software AS. This manual page was initially written by Dag-Erling
Smørgrav, and later updated by Per Buer and Martin Blix Grydeland.
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-2014 Varnish Software AS