|
|
Varnish 2.0 beta 2 (Default branch)
09-25-2008
|
|
VARNISHNCSA(1) VARNISHNCSA(1) NAME
varnishncsa - Display Varnish logs in Apache / NCSA combined log format SYNOPSIS
varnishncsa [-a] [-b] [-C] [-c] [-D] [-d] [-f] [-F format] [-I regex] [-i tag] [-n varnish_name] [-m tag:regex ...] [-P file] [-r file] [-V] [-w file] [-X regex] [-x tag] DESCRIPTION
The varnishncsa utility reads varnishd(1) shared memory logs and presents them in the Apache / NCSA "combined" log format. 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, varnishncsa 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, varnishncsa acts as if they both were. -D Daemonize. -d Process old log entries on startup. Normally, varnishncsa will only process entries which are written to the log after it starts. -f Prefer the X-Forwarded-For HTTP header over client.ip in the log output. -F format Specify the log format used. If no format is specified the default log format is used. Currently it is: %h %l %u %t "%r" %s %b "%{Referer}i" "%{User-agent}i" Supported formatters are: %b Size of response in bytes, excluding HTTP headers. In CLF format, i.e. a '-' rather than a 0 when no bytes are sent. %H The request protocol. Defaults to HTTP/1.0 if not known. %h Remote host. Defaults to '-' if not known. Defaults to 127.0.0.1 for backend requests. %{X}i The contents of request header line X. %l Remote logname (always '-') %m Request method. Defaults to '-' if not known. %q The query string, if no query string exists, an empty string. %{X}o The contents of response header line X. %r The first line of the request. Synthesized from other fields, so it may not be the request verbatim. %s Status sent to the client %t Time when the request was received, in HTTP date/time format. %U The request URL without any query string. Defaults to '-' if not known. %u Remote user from auth %{X}x Extended variables. Supported variables are: Varnish:time_firstbyte Time to the first byte from the backend arrived Varnish:hitmiss Whether the request was a cache hit or miss. Pipe and pass are considered misses. Varnish:handling How the request was handled, whether it was a cache hit, miss, pass, pipe or error. -m tag:regex only list records where tag matches regex. Multiple -m options are AND-ed together. -n Specifies the name of the varnishd instance to get logs from. If -n is not specified, the host name is used. -P file Write the process's PID to the specified file. -r file Read log entries from file instead of shared memory. -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 varnishncsa 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. If the -o option was specified, a tag and a regex argument must be given. varnishncsa will then only log for request groups which include that tag and the regular expression matches on that tag. SEE ALSO
o varnishd(1) o varnishhist(1) o varnishlog(1) o varnishstat(1) o varnishtop(1) HISTORY
The varnishncsa utility was developed by Poul-Henning Kamp in cooperation with Verdens Gang AS and Varnish Software AS. This manual page was written by Dag-Erling Smorgrav <des@des.no>. 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 1.0 2010-05-31 VARNISHNCSA(1)