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