varnishncsa [-a] [-C] [-d] [-D] [-F format] [-g <request|vxid>] [-h] [-n name] [-N filename] [-P file] [-q query] [-V] [-w filename]
The varnishncsa utility reads varnishd(1) shared memory logs and presents them in the Apache / NCSA "combined" log format.
Each log line produced is based on a single Request type transaction gathered from the shared memory log. The Request transaction is then scanned for the relevant parts in order to output one log line. To filter the log lines produced, use the query language to select the applicable transactions. Non-request transactions are ignored.
The following options are available:
-a | When writing output to a file, append to it rather than overwrite it. |
-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. |
-F format | Set the output log format string. |
-g <request|vxid> | |
The grouping of the log records. The default is to group by vxid. | |
-h | Print program usage and exit |
-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. |
-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. |
Specify the log format used. If no format is specified the default log format is used.
The default log format is:
%h %l %u %t "%r" %s %b "%{Referer}i" "%{User-agent}i"
Escape sequences \n and \t are supported.
Supported formatters are:
Extended variables. Supported variables are:
varnishd(1) varnishlog(1) varnishstat(1)
The varnishncsa utility was developed by Poul-Henning Kamp in cooperation with Verdens Gang AS and Varnish Software AS. This manual page was initially written by Dag-Erling Smørgrav <des@des.no>, and later updated by Martin Blix Grydeland.
This document is licensed under the same licence as Varnish itself. See LICENCE for details.