=========== varnishncsa =========== --------------------------------------------------------- Display Varnish logs in Apache / NCSA combined log format --------------------------------------------------------- :Author: Dag-Erling Smørgrav :Date: 2010-05-31 :Version: 1.0 :Manual section: 1 SYNOPSIS ======== varnishncsa [-a] [-b] [-C] [-c] [-D] [-d] [-f] [-I regex] [-i tag] [-n varnish_name] [-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. -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. -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. SEE ALSO ======== * varnishd(1) * varnishhist(1) * varnishlog(1) * varnishstat(1) * varnishtop(1) HISTORY ======= The varnishncsa utility was developed by Poul-Henning Kamp in cooperation with Verdens Gang AS and Linpro AS. This manual page was written by Dag-Erling Smørgrav ⟨des@des.no⟩. 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-2008 Linpro AS * Copyright (c) 2008-2010 Redpill Linpro AS * Copyright (c) 2010 Varnish Software AS