varnishlog (1) Linux Manual Page

NAME

varnishlog – Display Varnish logs

SYNOPSIS

varnishlog [-a] [-b] [-B] [-c] [-C] [-d] [-D] [-g <session|request|vxid|raw>] [-h] [-i taglist] [-I <[taglist:]regex>] [-k num] [-L limit] [-n name] [-N filename] [-P file] [-q query] [-r filename] [-T seconds] [-v] [-V] [-w filename] [-x taglist] [-X <[taglist:]regex>]

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. The -w option specifies where the binary output is written.

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

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

-k num

Process this number of matching log transactions before exiting.

-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. The file can be created with varnishlog -B -w filename.

-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

•

varnishd(1)

•

varnishhist(1)

•

varnishncsa(1)

•

varnishstat(1)

•

varnishtop(1)

•

vsl(7)

•

vsl-query(7)

HISTORY

The varnishlog utility was developed by Poul-Henning Kamp <phk [at] 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

Index