varnishlog

Отображение журналов Varnish

Раздел справки:: 1

СВОДКА

varnishlog [-a] [-A] [-b] [-c] [-C] [-d] [-D] [-E] [-g <сессия|запрос|vxid|сырой>] [-h] [-i <список тегов>] [-I <[список тегов:]регулярное выражение>] [-k <число>] [-L <предел>] [-n <каталог>] [-P <файл>] [-Q <файл>] [-q <запрос>] [-r <имя файла>] [-R <предел[/продолжительность]>] [-t <секунды|выкл>] [-T <секунды>] [-u] [-v] [-V] [-w <имя файла>] [-x <список тегов>] [-X <[список тегов:]регулярное выражение>]

ПАРАМЕТРЫ

Доступны следующие параметры:

-a

При записи вывода в файл с помощью параметра -w, добавлять данные в конец файла вместо перезаписи. Этот параметр не действует без параметра -w.

-A

При записи вывода в файл с помощью параметра -w, выводить данные в формате ASCII. Этот параметр не действует без параметра -w.

-b

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

-c

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

-C

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

-d

Обрабатывать записи журнала в начале журнала и завершать работу.

-D

Запустить в демоне.

-E

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

-g <сессия|запрос|vxid|сырой>

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

-h

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

-i <список тегов>

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

Если параметр включения тега является первым среди параметров выбора тегов, все теги сначала помечаются как исключенные.

-I <[список тегов:]регулярное выражение>

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

-k <число>

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

-L <предел>

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

-n <каталог>

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

-P <файл>

Записать PID процесса в указанный файл.

-Q <файл>

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

-q <запрос>

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

-r <имя файла>

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

-R <предел[/продолжительность]>

Ограничить вывод указанным пределом. Транзакции, превышающие предел, будут подавлены. Предел задается как максимальное число транзакций (с учётом выбранного метода группировки) и необязательный временной интервал. Если продолжительность не указана, используется значение по умолчанию s. Поле продолжительности может быть отформатировано как в VCL (например, -R 10/2m) или как просто временной интервал без префикса (например, -R 5/m). При группировке по -g raw, это значение не может использоваться вместе с -i, -I, -x или -X, и мы рекомендуем использовать -q вместо этого.

-t <секунды|выкл>

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

-T <секунды>

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

-u

При записи вывода в файл с помощью параметра -w, данные не буферизуются. Этот параметр не действует без параметра -w.

-v

Использовать подробный вывод при печати набора записей, указывая VXID в каждой строке журнала. Без этого параметра VXID будет выведен только в заголовке транзакции.

-V

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

-w <имя файла>

Перенаправить вывод в файл. Файл будет перезаписан, если не был указан параметр -a. Если приложение получит SIGHUP в режиме демона, файл будет открыт заново, позволяя старому быть удалённым. Затем файл может быть прочитан varnishlog и другими средствами с параметром -r, если не был указан параметр -A. Этот параметр необходим при работе в режиме демона. Если имя файла - «-», varnishlog записывает в стандартный вывод и не может работать как демон.

-x <список тегов>

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

-X <[список тегов:]регулярное выражение>

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

--optstring

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

СИГНАЛЫ

SIGHUP

Перезаписать журнал (см. параметр -w) в режиме демона, прервать цикл и завершить работу без ошибок при запуске в фоновом режиме.
SIGUSR1

Очистить все ожидающие транзакции

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

ИСТОРИЯ

Утилита varnishlog была разработана Poul-Henning Kamp <phk@phk.freebsd.dk> в сотрудничестве с Verdens Gang AS и Varnish Software AS. Эта страница руководства первоначально была написана Dag-Erling Smørgrav, а затем обновлена Per Buer и Martin Blix Grydeland.

АВТОРСКИЕ ПРАВА

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