varnishstat

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

varnishstat [-1] [-f <glob>] [-h] [-I <glob>] [-j] [-l] [-n <dir>] [-r] [-t <секунды|выкл>] [-V] [-X <glob>] [-x]

ОПИСАНИЕ

Утилита varnishstat отображает статистику работающего экземпляра varnishd(1).

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

-1

Вместо отображения непрерывно обновляемой информации, выводит статистику в стандартный вывод.

-f <glob>

Glob для фильтрации полей (старая версия). Используйте обратную косую черту для экранирования символов. Если аргумент начинается с ‘^’, он используется как эксклюзивный glob. Можно указать несколько аргументов -f. Фильтрация по старым globs выполняется вместе с включением globs (-I) и исключением globs (-X) в порядке их указания, на основе принципа первого совпадения.

-h

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

-I <glob>

Glob для включения полей. Используйте обратную косую черту для экранирования символов. Можно указать несколько аргументов -I. Фильтры исключения обрабатываются в порядке указания вместе с исключающими globs (-X) и старыми фильтрами (-f) на основе принципа первого совпадения.

-j

Выводит статистику в стандартный вывод в формате JSON.

-l

Отображает доступные поля для использования с опцией -f.

-n <dir>

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

-r

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

-t <seconds|off>

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

-V

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

-X <glob>

Glob для исключения полей. Используйте обратную косую черту для экранирования символов. Можно указать несколько аргументов -X. Фильтры исключения обрабатываются в порядке указания вместе с включения globs (-I) и старыми фильтрами (-f) на основе принципа первого совпадения.

-x

Выводит статистику в стандартный вывод в формате XML.

--optstring

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

РЕЖИМ CURSES

Если ни одна из опций -1, -j или -x не указана, приложение запускается в режиме curses. Это отображает постоянно обновляемый вид значений счетчиков вместе с их описанием.

Верхняя область отображает информацию о времени работы процесса.

Центральная область отображает список значений счетчиков.

Нижняя область отображает описание текущего выбранного счетчика.

При запуске отображаются только счетчики уровня INFO.

ВЫВОДЫ

Формат XML вывода:

<varnishstat timestamp="YYYY-MM-DDTHH:mm:SS">
  <stat>
    <name>FIELD NAME</name>
    <value>FIELD VALUE</value>
    <flag>FIELD SEMANTICS</flag>
    <format>FIELD DISPLAY FORMAT</format>
    <description>FIELD DESCRIPTION</description>
  </stat>
  [..]
</varnishstat>

Формат JSON вывода:

{
  "timestamp": "YYYY-MM-DDTHH:mm:SS",
  "FIELD NAME": {
    "description": "FIELD DESCRIPTION",
    "flag": "FIELD SEMANTICS", "format": "FIELD DISPLAY FORMAT",
    "value": FIELD VALUE
  },
  "FIELD NAME": {
    "description": "FIELD DESCRIPTION",
    "flag": "FIELD SEMANTICS", "format": "FIELD DISPLAY FORMAT",
    "value": FIELD VALUE
  },
  [..]
}

Отметка времени - время, когда отчет был сгенерирован varnishstat.

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

• varnishd
• varnishhist
• varnishlog
• varnishncsa
• varnishtop
• curses(3)
• varnish-counters

АВТОРЫ

Эта страница руководства была написана Dag-Erling Smørgrav, Per Buer, Lasse Karstensen и Martin Blix Grydeland.