VARNISHTOP(1)

NAME

varnishtop -- Varnish log entry ranking

SYNOPSIS

varnishtop [-1] [-b] [-C] [-c] [-d] [-f] [-I regex] [-i tag]
           [-n varnish_name] [-r file] [-V] [-X regex] [-x tag]

DESCRIPTION

The varnishtop utility reads varnishd(1) shared memory logs and presents a continuously updated list of the most commonly occurring log entries.
With suitable filtering using the -I, -i, -X and -x options, it can be used to display a ranking of requested documents, clients, user agents,
or any other information which is recorded in the log.

The following options are available:

-1 Instead of presenting of a continuously updated display,

print the statistics once and exit. Implies -d.

-b Include log entries which result from communication with a

backend server. If neither -b nor -c is specified,
varnishtop 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, varnishtop acts as if they both were.

-d Process old log entries on startup. Normally, varnishtop

will only process entries which are written to the log after it starts.

-f Sort and group only on the first field of each log entry.

This is useful when displaying e.g. stataddr entries, where the first field is the client IP address.

-I regex Include log entries which match the specified regular expres

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

-r file Read log entries from file instead of shared memory.

-V Display the version number and exit.

-X regex Exclude log entries which match the specified regular expres

sion.

-x tag Exclude log entries with the specified tag.

EXAMPLES

The following example displays a continuously updated list of the most
frequently requested URLs:

varnishtop -i RxURL

The following example displays a continuously updated list of the most
commonly used user agents:

varnishtop -i RxHeader -C -I \^User-Agent

SEE ALSO

varnishd(1), varnishhist(1), varnishlog(1), varnishncsa(1),
varnishstat(1)

HISTORY

The varnishtop utility was originally developed by Poul-Henning Kamp <phk@phk.freebsd.dk> in cooperation with Verdens Gang AS and Linpro AS,
and later substantially rewritten by Dag-Erling Smrgrav <des@des.no>.
This manual page was written by Dag-Erling Smrgrav <des@des.no>.

BSD June 28, 2007 BSD