Scroll to navigation

VARNISHSIZES(1) VARNISHSIZES(1)

NAME

varnishsizes - Varnish object size request histogram

SYNOPSIS

varnishsizes [-b] [-C] [-c] [-d] [-I regex] [-i tag] [-m tag:regex ...]
 
[-n varnish_name] [-r file] [-V] [-w delay] [-X regex] [-x tag]

DESCRIPTION

The varnishsizes utility reads varnishd(1) shared memory logs and presents a continuously updated histogram showing the distribution of the last N requests by their processing. The value of N and the vertical scale are displayed in the top left corner. The horizontal scale is a logarithmic representation of bytes. Hits are marked with a pipe character ("|"), and misses are marked with a hash character ("#").
 
The following options are available:
-b
Include log entries which result from communication with a backend server. If neither -b nor -c is specified, varnishsizes 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, varnishsizes acts as if they both were.
-d
Process old log entries on startup. Normally, varnishsizes will only process entries which are written to the log after it starts.
-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.

-m tag:regex only list record 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.
-r file
Read log entries from file instead of shared memory.
-V
Display the version number and exit.
-w delay
Wait at least delay seconds between each update. The default is 1. file instead of displaying them. The file will be overwritten unless the -a option was specified.
-X regex
Exclude log entries which match the specified regular expression.
-x tag
Exclude log entries with the specified tag.

SEE ALSO

varnishd(1)
varnishlog(1)
varnishncsa(1)
varnishstat(1)
varnishtop(1)

HISTORY

The varnishsizes utility was developed by Kristian Lyngstøl based on varnishhist. This manual page was written by Kristian Lyngstøl, Dag-Erling Smørgrav and Per Buer.

COPYRIGHT

This document is licensed under the same licence as Varnish itself. See LICENCE for details.
Copyright (c) 2010 Varnish Software AS

AUTHOR

Dag Erling Smørgrav, Kristian Lyngstøl, Per Buer
2010-05-31 1.0