varnishhist

Гистограмма запросов Varnish

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

СИНOPSIS

varnishhist [-B <фактор>] [-C] [-d] [-g <запрос|vxid>] [-h] [-L <предел>] [-n <каталог>] [-p <период>] [-P responsetime] [-P reqbodytime] [-P размер] [-P Bereqtime] [-P Beresptime] [-P BerespBodytime] [-P Besize] [-P <[cb:]тег:[префикс]:номер_поля[:мин:макс]>] [-Q <файл>] [-q <запрос>] [-r <имя_файла>] [-t <секунды|выкл>] [-T <секунды>] [-V]

ОПИСАНИЕ

Утилита varnishhist считывает журналы общей памяти varnishd(1) и отображает непрерывно обновляемую гистограмму, показывающую распределение последних N запросов в соответствии с их обработкой. Значение N и вертикальная шкала отображаются в левом верхнем углу. Горизонтальная шкала является логарифмической. Удачные запросы помечаются символом «|», а неудачные — символом «#».

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

-B <фактор>: Фактор изменения времени. Особенно полезен при чтении из файла vsl. =1 обрабатывает в реальном времени, <1 замедляет, >1 ускоряет (бесполезно, если не читается из файла). Во время выполнения < уменьшает вдвое, а > увеличивает вдвое.
-C: Выполнять все сопоставления по регулярным выражениям и строкам без учета регистра.
-d: Обрабатывать записи журнала в начале журнала и завершать работу.
-g <запрос|vxid>: Группировка записей журнала. По умолчанию группировка производится по vxid.
-h: Вывести справку по использованию программы и завершить работу.
-L <предел>: Устанавливает верхний предел незавершенных транзакций, хранящихся перед завершением самой старой транзакции. При этом генерируется предупреждающая запись. Это ограничение сохраняет верхнюю границу использования памяти при выполнении запросов. По умолчанию 1000 транзакций.
-n <каталог>: Указывает рабочий каталог varnishd (также известный как имя экземпляра) для получения журналов. Если -n не указан, используется имя хоста.
-p <период>: Устанавливает количество секунд между обновлениями экрана. По умолчанию 1 секунда, может быть изменено во время работы, нажимая клавиши [0-9] (степени двойки в секундах) или + и - (удваивает/уменьшает вдвое скорость).
-P responsetime: Предопределённый профиль клиента: отображать общее время с начала обработки запроса (получение первого байта) до готовности к передаче ответа клиенту (поле 3 SLT_Timestamp Process: VSL tag).
-P reqbodytime: Предопределённый профиль клиента: отображать время чтения тела запроса (поле 3 SLT_Timestamp ReqBody: VSL tag).
-P размер: Предопределённый профиль клиента: отображать размер ответов (поле 5 SLT_ReqAcct VSL tag).
-P Bereqtime: Предопределённый профиль бэкенда: отображать время с начала обработки бэкенда до полного отправления запроса на бэкенд (поле 3 SLT_Timestamp Bereq: VSL tag).
-P Beresptime: Предопределённый профиль бэкенда: отображать время с начала обработки бэкенда до полного получения заголовков ответа (поле 3 SLT_Timestamp Beresp: VSL tag).
-P BerespBodytime: Предопределённый профиль бэкенда: отображать время с начала обработки бэкенда до получения всего тела ответа (поле 3 SLT_Timestamp BerespBody: VSL tag).
-P Besize: Предопределённый профиль бэкенда: отображать размер тела ответа бэкенда (поле 5 SLT_BereqAcct VSL tag).
-P <[cb:]тег:[префикс]:номер_поля[:мин:макс]>: Отображать пользовательское определение: необязательный (c)lient, (b)ackend или (E)SI фильтр (по умолчанию клиент), тег, который мы ищем, префикс для поиска (может быть пустым, но должен завершаться двоеточием) и номер поля значения, которое нас интересует. Минимальное и максимальное значения графика задаются в степенях десяти и по умолчанию равны -6 и 3.
-Q <файл>: Указывает файл, содержащий VSL запрос для использования. Если указано несколько параметров -Q или -q, все запросы рассматриваются так, как будто использовался оператор «или» для их объединения.
-q <запрос>: Указывает VSL запрос для использования. Если указано несколько параметров -q или -Q, все запросы рассматриваются так, как будто использовался оператор «или» для их объединения.
-r <имя_файла>: Считывать журнал в двоичном формате из этого файла. Файл может быть создан с помощью varnishlog -w filename. Если имя файла -, журналы считываются со стандартного ввода. Не может работать как демон.
-t <секунды|выкл>: Таймаут ожидания ответа на первоначальное подключение к VSM. Если задано, подключение к VSM повторно устанавливается каждые 0,5 секунды в течение указанного количества секунд. Если ноль, подключение выполняется только один раз и немедленно завершается при неудаче. Если установлено «выкл», подключение не будет провалено, позволяя утилите начать работу и ожидать бесконечно появления экземпляра Varnish.
-T <секунды>: Устанавливает таймаут транзакции в секундах. Это определяет максимальное количество секунд, прошедших между меткой «Begin» и меткой «End». Если таймаут истекает, генерируется предупреждающая запись, и транзакция завершается принудительно. По умолчанию 120 секунд.
-V: Вывести информацию о версии и завершить работу.
--optstring: Вывести параметр optstring для getopt(3) для помощи в написании скриптов-обёртки.

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

ИСТОРИЯ

Утилита varnishhist была разработана Poul-Henning Kamp в сотрудничестве с Verdens Gang AS и Varnish Software AS. Данная страница руководства была написана Dag-Erling Smørgrav.

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

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