varnishtop

Отображение рейтинга записей журнала Varnish

Раздел Руководства:: 1

Сводка

varnishtop [-1] [-b] [-c] [-C] [-d] [-E] [-f] [-g <session|request|vxid|raw>] [-h] [-i <taglist>] [-I <[taglist:]regex>] [-L <limit>] [-n <dir>] [-p <period>] [-Q <file>] [-q <query>] [-r <filename>] [-t <seconds|off>] [-T <seconds>] [-x <taglist>] [-X <[taglist:]regex>] [-V]

Описание

Утилита varnishtop считывает журналы общей памяти varnishd и отображает постоянно обновляемый список наиболее часто встречающихся записей журнала. При помощи подходящей фильтрации с помощью опций -I, -i, -X и -x, она может использоваться для отображения рейтинга запрошенных документов, клиентов, пользовательских агентов или любой другой информации, которая записывается в журнале.

Доступны следующие опции:

-1

Вместо постоянно обновляемого отображения выводит статистику один раз и завершается. Подразумевает -d.

-b

Отображаются только транзакции и записи журнала, поступающие от взаимодействия с бэкендом.

-c

Отображаются только транзакции и записи журнала, поступающие от взаимодействия с клиентом.

-C

Все сопоставления регулярных выражений и строк выполняются без учета регистра.

-d

Обрабатываются записи журнала в начале журнала.

-E

Отображаются транзакции ESI и другие типы подзапросов. Это подразумевает опцию -c и включает другие клиентские транзакции.

-f

Сортировка и группировка только по первому полю каждой записи журнала. Для записей журнала в формате prefix: value сортируется и группируется префикс без двоеточия. Это полезно при отображении, например, записей ReqStart, где первое поле — IP-адрес клиента.

-g <session|request|vxid|raw>

Группировка записей журнала. По умолчанию группировка производится по vxid.

-h

Выводит информацию об использовании программы и завершает работу.

-i <taglist>

Включает записи журнала с указанными тегами в выходные данные. Список тегов — это список тегов, разделенных запятыми. Может быть указано несколько опций -i.

Если опция включения тега — первая из всех опций выбора тегов, все теги помечаются как исключённые.

-I <[taglist:]regex>

Включает по соответствию с регулярным выражением. Выводятся только записи, соответствующие списку тегов и регулярному выражению. При отсутствии списка тегов применяется к любому тегу. Может быть указано несколько опций -I.

Если опция включения тега — первая из всех опций выбора тегов, все теги помечаются как исключённые.

-L <limit>

Устанавливает максимальное количество неполных транзакций, хранящихся перед принудительным завершением самой старой транзакции. При этом генерируется сообщение об ошибке. Это ограничение позволяет ограничить использование памяти при выполнении запросов. По умолчанию 1000 транзакций.

-n <dir>

Указывает рабочую директорию varnishd (также известную как имя экземпляра) для получения журналов. Если -n не указан, используется имя хоста.

-p <period>

Указывает количество секунд для измерения. По умолчанию 60 секунд. Первое число в списке — среднее количество запросов за этот период времени. Эта опция не влияет, если используется опция -1.

-Q <file>

Указывает файл, содержащий запрос VSL для использования. Если указано несколько опций -Q или -q, все запросы рассматриваются так, как будто используется оператор «или» для их объединения.

-q <query>

Указывает запрос VSL для использования. Если указано несколько опций -q или -Q, все запросы рассматриваются так, как будто используется оператор «или» для их объединения.

-r <filename>

Чтение журнала в формате двоичного файла из этого файла. Файл можно создать с помощью varnishlog -w filename. Если имя файла -, журналы считываются со стандартного ввода. И не может работать как демон.

-t <seconds|off>

Таймаут ожидания перед возвратом ошибки при первоначальном подключении к VSM. Если установлено, подключение к VSM повторяется каждые 0,5 секунды в течение указанного количества секунд. Если равно нулю, подключение пытается один раз и немедленно завершается, если оно не удается. Если установлено «выкл.», подключение не будет прерываться, позволяя утилите начинаться и бесконечно ждать появления экземпляра Varnish.

-T <seconds>

Устанавливает таймаут транзакции в секундах. Это определяет максимальное количество секунд, прошедших между тегом Begin и тегом End. Если таймаут истекает, генерируется сообщение об ошибке, и транзакция завершается принудительно. По умолчанию 120 секунд.

-x <taglist>

Исключает записи журнала с указанными тегами из выходных данных. Список тегов — это список тегов, разделенных запятыми. Может быть указано несколько опций -x.

-X <[taglist:]regex>

Исключить по соответствию с регулярным выражением. Не выводить записи, соответствующие списку тегов и регулярному выражению. При отсутствии списка тегов применяется ко всем тегам. Может быть указано несколько опций -X.

-V

Выводит информацию о версии и завершает работу.

--optstring

Выводит параметр optstring к getopt(3) для помощи в написании скриптов-оберток.

ПРИМЕРЫ

Следующий пример отображает постоянно обновляемый список наиболее часто запрашиваемых URL:

varnishtop -i ReqURL

Следующий пример отображает постоянно обновляемый список наиболее часто используемых пользовательских агентов:

varnishtop -C -I ReqHeader:User-Agent

СМОТРИТЕ ТАКЖЕ

История

Утилита varnishtop была первоначально разработана Poul-Henning Kamp в сотрудничестве с Verdens Gang AS и Varnish Software AS, а затем существенно переработана Dag-Erling Smørgrav. Эта страница руководства была написана Dag-Erling Smørgrav и позже обновлена Martin Blix Grydeland.

Авторские права

Этот документ лицензирован под той же лицензией, что и сам Varnish. Подробности см. в файле LICENCE.