.. Copyright (c) 2010-2015 Varnish Software AS SPDX-License-Identifier: BSD-2-Clause See LICENSE file for full text of license

.. role:: ref(emphasis)

.. _varnishtop(1):

========== varnishtop

---

Varnish log entry ranking

:Manual section: 1

SYNOPSIS

.. include:: ../include/varnishtop_synopsis.rst varnishtop |synopsis|

DESCRIPTION

The varnishtop utility reads :ref: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:

.. include:: ../include/varnishtop_options.rst

EXAMPLES

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

varnishtop -i ReqURL

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

varnishtop -C -I ReqHeader:User-Agent

SEE ALSO

• :ref:varnishd(1)
• :ref:varnishhist(1)
• :ref:varnishlog(1)
• :ref:varnishncsa(1)
• :ref:varnishstat(1)

HISTORY

The varnishtop utility was originally developed by Poul-Henning Kamp in cooperation with Verdens Gang AS and Varnish Software AS, and later substantially rewritten by Dag-Erling Smørgrav. This manual page was written by Dag-Erling Smørgrav, and later updated by Martin Blix Grydeland.

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-2015 Varnish Software AS