Перейти к содержанию

vts: Модуль статуса трафика виртуального хоста NGINX

Установка на Debian/Ubuntu

Эти документы относятся к пакету APT nginx-module-vts, предоставляемому репозиторием GetPageSpeed Extras.

  1. Настройте репозиторий APT, как описано в настройке репозитория APT.
  2. Установите модуль:
sudo apt-get update
sudo apt-get install nginx-module-vts
Показать дистрибутивы и архитектуры 
| Дистрибутив | Версия           | Компонент   | Архитектуры     |
|-------------|------------------|-------------|------------------|
| debian      | bookworm         | main        | amd64, arm64     |
| debian      | bookworm-mainline| main        | amd64, arm64     |
| debian      | trixie           | main        | amd64, arm64     |
| debian      | trixie-mainline  | main        | amd64, arm64     |
| ubuntu      | focal            | main        | amd64, arm64     |
| ubuntu      | focal-mainline   | main        | amd64, arm64     |
| ubuntu      | jammy            | main        | amd64, arm64     |
| ubuntu      | jammy-mainline   | main        | amd64, arm64     |
| ubuntu      | noble            | main        | amd64, arm64     |
| ubuntu      | noble-mainline   | main        | amd64, arm64     |

CI License

Модуль состояния трафика виртуального хоста Nginx

Тест

Запустите sudo prove -r t после установки этого модуля. sudo требуется, потому что тесту необходимо, чтобы Nginx слушал на порту 80.

Скриншоты

screenshot-vts-0

screenshot-vts-1

Синопсис

http {
    vhost_traffic_status_zone;

    ...

    server {

        ...

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}

Описание

Это модуль Nginx, который предоставляет доступ к информации о состоянии виртуального хоста. Он содержит текущее состояние, такое как сервера, верхние уровни, кэши. Это похоже на мониторинг активности в реальном времени Nginx Plus. Встроенный HTML также взят с демонстрационной страницы старой версии.

Прежде всего, требуется директива vhost_traffic_status_zone, а затем, если директива vhost_traffic_status_display установлена, доступ к ней можно получить следующим образом:

  • /status/format/json
  • Если вы запрашиваете /status/format/json, ответ будет в виде документа JSON, содержащего текущие данные активности для использования в панелях мониторинга в реальном времени и сторонних инструментах мониторинга.
  • /status/format/html
  • Если вы запрашиваете /status/format/html, ответ будет в виде встроенной панели мониторинга в HTML, которая внутренне запрашивает /status/format/json.
  • /status/format/jsonp
  • Если вы запрашиваете /status/format/jsonp, ответ будет в виде функции обратного вызова JSONP, содержащей текущие данные активности для использования в панелях мониторинга в реальном времени и сторонних инструментах мониторинга.
  • /status/format/prometheus
  • Если вы запрашиваете /status/format/prometheus, ответ будет в виде документа prometheus, содержащего текущие данные активности.
  • /status/control
  • Если вы запрашиваете /status/control, ответ будет в виде документа JSON после сброса или удаления зон через строку запроса. См. Управление.

Документ JSON содержит следующее:

{
    "hostName": ...,
    "moduleVersion": ...,
    "nginxVersion": ...,
    "loadMsec": ...,
    "nowMsec": ...,
    "connections": {
        "active":...,
        "reading":...,
        "writing":...,
        "waiting":...,
        "accepted":...,
        "handled":...,
        "requests":...
    },
    "sharedZones": {
        "name":...,
        "maxSize":...,
        "usedSize":...,
        "usedNode":...
    },
    "serverZones": {
        "...":{
            "requestCounter":...,
            "inBytes":...,
            "outBytes":...,
            "responses":{
                "1xx":...,
                "2xx":...,
                "3xx":...,
                "4xx":...,
                "5xx":...,
                "miss":...,
                "bypass":...,
                "expired":...,
                "stale":...,
                "updating":...,
                "revalidated":...,
                "hit":...,
                "scarce":...
            },
            "requestMsecCounter":...,
            "requestMsec":...,
            "requestMsecs":{
                "times":[...],
                "msecs":[...]
            },
            "requestBuckets":{
                "msecs":[...],
                "counters":[...]
            },
        }
        ...
    },
    "filterZones": {
        "...":{
            "...":{
                "requestCounter":...,
                "inBytes":...,
                "outBytes":...,
                "responses":{
                    "1xx":...,
                    "2xx":...,
                    "3xx":...,
                    "4xx":...,
                    "5xx":...,
                    "miss":...,
                    "bypass":...,
                    "expired":...,
                    "stale":...,
                    "updating":...,
                    "revalidated":...,
                    "hit":...,
                    "scarce":...
                },
                "requestMsecCounter":...,
                "requestMsec":...,
                "requestMsecs":{
                    "times":[...],
                    "msecs":[...]
                },
                "requestBuckets":{
                    "msecs":[...],
                    "counters":[...]
                },
            },
            ...
        },
        ...
    },
    "upstreamZones": {
        "...":[
            {
                "server":...,
                "requestCounter":...,
                "inBytes":...,
                "outBytes":...,
                "responses":{
                    "1xx":...,
                    "2xx":...,
                    "3xx":...,
                    "4xx":...,
                    "5xx":...
                },
                "requestMsecCounter":...,
                "requestMsec":...,
                "requestMsecs":{
                    "times":[...],
                    "msecs":[...]
                },
                "requestBuckets":{
                    "msecs":[...],
                    "counters":[...]
                },
                "responseMsecCounter":...,
                "responseMsec":...,
                "responseMsecs":{
                    "times":[...],
                    "msecs":[...]
                },
                "responseBuckets":{
                    "msecs":[...],
                    "counters":[...]
                },
                "weight":...,
                "maxFails":...,
                "failTimeout":...,
                "backup":...,
                "down":...
            }
            ...
        ],
        ...
    }
    "cacheZones": {
        "...":{
            "maxSize":...,
            "usedSize":...,
            "inBytes":...,
            "outBytes":...,
            "responses":{
                "miss":...,
                "bypass":...,
                "expired":...,
                "stale":...,
                "updating":...,
                "revalidated":...,
                "hit":...,
                "scarce":...
            }
        },
        ...
    }
}
  • main
  • Базовая версия, время работы((nowMsec - loadMsec)/1000)
  • nowMsec, loadMsec в миллисекундах.
  • connections
  • Общее количество соединений и запросов (то же самое, что и stub_status_module в NGINX)
  • sharedZones
  • Информация о разделяемой памяти, используемой в nginx-module-vts.
  • serverZones
  • Трафик (входящий/исходящий) и количество запросов и ответов, а также коэффициент попадания в кэш для каждой зоны сервера
  • Общий трафик (входящий/исходящий) и количество запросов и ответов (имя зоны - *) и коэффициент попадания
  • filterZones
  • Трафик (входящий/исходящий) и количество запросов и ответов, а также коэффициент попадания в кэш для каждой зоны сервера, отфильтрованной через директиву vhost_traffic_status_filter_by_set_key
  • Общий трафик (входящий/исходящий) и количество запросов и ответов (имя зоны - *) и коэффициент попадания, отфильтрованный через директиву vhost_traffic_status_filter_by_set_key
  • upstreamZones
  • Трафик (входящий/исходящий) и количество запросов и ответов для серверов в каждой группе upstream
  • Текущие параметры (вес, maxfails, failtimeout...) в nginx.conf
  • cacheZones
  • Трафик (входящий/исходящий) и размер (вместимость/используемый) и коэффициент попадания для каждой зоны кэша при использовании директивы proxy_cache.

Объекты overCounts в документе JSON в основном предназначены для 32-битных систем и будут увеличиваться на 1, если их значение переполнено. Директива vhost_traffic_status_display_format устанавливает формат по умолчанию, который является одним из json, jsonp, html, prometheus. (По умолчанию: json)

Расчет трафика выполняется следующим образом:

  • ServerZones
  • in += requested_bytes
  • out += sent_bytes
  • FilterZones
  • in += requested_bytes через фильтр
  • out += sent_bytes через фильтр
  • UpstreamZones
  • in += requested_bytes через ServerZones
  • out += sent_bytes через ServerZones
  • cacheZones
  • in += requested_bytes через ServerZones
  • out += sent_bytes через ServerZones

Все вычисления происходят на этапе обработки логов Nginx. Внутренние перенаправления (X-Accel-Redirect или error_page) не учитываются в UpstreamZones.

Предостережения: этот модуль зависит от системы логирования nginx (NGX_HTTP_LOG_PHASE: последний этап http nginx), поэтому трафик может быть в определенных обстоятельствах отличен от реального трафика по полосе пропускания. Websocket, отмененные загрузки могут быть причиной неточностей. Работа модуля не зависит от того, включена ли директива access_log "включена" или "выключена". Еще раз, этот модуль работает хорошо при "access_log off". При использовании нескольких доменов он устанавливается как первый домен (слева) директивы server_name. Если вы этого не хотите, смотрите директивы vhost_traffic_status_filter_by_host, vhost_traffic_status_filter_by_set_key.

Смотрите следующие модули для статистики трафика stream: * nginx-module-sts * nginx-module-stream-sts

Вычисления и Интервалы

Средние значения

Все средние значения в настоящее время рассчитываются как AMM(арифметическое среднее) за последние 64 значения.

Управление

Он способен сбросить или удалить зоны трафика через строку запроса. Запрос отвечает документом JSON.

  • Синтаксис URI
  • /{status_uri}/control?cmd={command}&group={group}&zone={name}
http {

    geoip_country /usr/share/GeoIP/GeoIP.dat;

    vhost_traffic_status_zone;
    vhost_traffic_status_filter_by_set_key $geoip_country_code country::*;

    ...

    server {

        server_name example.org;

        ...

        vhost_traffic_status_filter_by_set_key $geoip_country_code country::$server_name;

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}

Если он установлен, как указано выше, то контрольный uri выглядит как example.org/status/control.

Доступные параметры запроса следующие: * cmd=\<status|reset|delete> * status * Возвращает статус зон трафика в формате json, как status/format/json. * reset * Сбрасывает зоны трафика, не удаляя узлы в общей памяти. (= инициализация в 0) * delete * Удаляет зоны трафика из общей памяти. При повторном запросе создаются заново. * group=\<server|filter|upstream@alone|upstream@group|cache|*> * server * filter * upstream@alone * upstream@group * cache * * * zone=name * server * name * filter * filter_group@name * upstream@group * upstream_group@name * upstream@alone * @name * cache * name

Получение статуса зон трафика на лету

Это похоже на status/format/json, за исключением того, что можно получить каждую зону.

Для получения всех зон

  • Это точно так же, как status/format/json.
  • /status/control?cmd=status&group=*

Для получения групповых зон

  • mainZones
  • /status/control?cmd=status&group=server&zone=::main
  • serverZones
  • /status/control?cmd=status&group=server&zone=*
  • filterZones
  • /status/control?cmd=status&group=filter&zone=*
  • upstreamZones
  • /status/control?cmd=status&group=upstream@group&zone=*
  • upstreamZones::nogroups
  • /status/control?cmd=status&group=upstream@alone&zone=*
  • cacheZones
  • /status/control?cmd=status&group=cache&zone=*

Значения mainZones — это значения статуса по умолчанию, включая hostName, moduleVersion, nginxVersion, loadMsec, nowMsec, connections.

Для получения каждой зоны

  • единственная зона в serverZones
  • /status/control?cmd=status&group=server&zone=name
  • единственная зона в filterZones
  • /status/control?cmd=status&group=filter&zone=filter_group@name
  • единственная зона в upstreamZones
  • /status/control?cmd=status&group=upstream@group&zone=upstream_group@name
  • единственная зона в upstreamZones::nogroups
  • /status/control?cmd=status&group=upstream@alone&zone=name
  • единственная зона в cacheZones
  • /status/control?cmd=status&group=cache&zone=name

Сброс зон трафика на лету

Он сбрасывает значения указанных зон в 0.

Для сброса всех зон

  • /status/control?cmd=reset&group=*

Для сброса групповых зон

  • serverZones
  • /status/control?cmd=reset&group=server&zone=*
  • filterZones
  • /status/control?cmd=reset&group=filter&zone=*
  • upstreamZones
  • /status/control?cmd=reset&group=upstream@group&zone=*
  • upstreamZones::nogroups
  • /status/control?cmd=reset&group=upstream@alone&zone=*
  • cacheZones
  • /status/control?cmd=reset&group=cache&zone=*

Для сброса каждой зоны

  • единственная зона в serverZones
  • /status/control?cmd=reset&group=server&zone=name
  • единственная зона в filterZones
  • /status/control?cmd=reset&group=filter&zone=filter_group@name
  • единственная зона в upstreamZones
  • /status/control?cmd=reset&group=upstream@group&zone=upstream_group@name
  • единственная зона в upstreamZones::nogroups
  • /status/control?cmd=reset&group=upstream@alone&zone=name
  • единственная зона в cacheZones
  • /status/control?cmd=reset&group=cache&zone=name

Удаление зон трафика на лету

Он удаляет указанные зоны из общей памяти.

Для удаления всех зон

  • /status/control?cmd=delete&group=*

Для удаления групповых зон

  • serverZones
  • /status/control?cmd=delete&group=server&zone=*
  • filterZones
  • /status/control?cmd=delete&group=filter&zone=*
  • upstreamZones
  • /status/control?cmd=delete&group=upstream@group&zone=*
  • upstreamZones::nogroups
  • /status/control?cmd=delete&group=upstream@alone&zone=*
  • cacheZones
  • /status/control?cmd=delete&group=cache&zone=*

Для удаления каждой зоны

  • единственная зона в serverZones
  • /status/control?cmd=delete&group=server&zone=name
  • единственная зона в filterZones
  • /status/control?cmd=delete&group=filter&zone=filter_group@name
  • единственная зона в upstreamZones
  • /status/control?cmd=delete&group=upstream@group&zone=upstream_group@name
  • единственная зона в upstreamZones::nogroups
  • /status/control?cmd=delete&group=upstream@alone&zone=name
  • единственная зона в cacheZones
  • /status/control?cmd=delete&group=cache&zone=name

Set

С помощью директивы vhost_traffic_status_set_by_filter можно отдельно получить значения статусов в конфигурации nginx. Она может получить почти все значения статусов, и полученное значение сохраняется в переменной, определяемой пользователем, которая является первым аргументом.

  • Синтаксис директивы
  • vhost_traffic_status_set_by_filter $variable group/zone/name
http {

    geoip_country /usr/share/GeoIP/GeoIP.dat;

    vhost_traffic_status_zone;
    vhost_traffic_status_filter_by_set_key $geoip_country_code country::*;

    ...
    upstream backend {
        10.10.10.11:80;
        10.10.10.12:80;
    }

    server {

        server_name example.org;

        ...

        vhost_traffic_status_filter_by_set_key $geoip_country_code country::$server_name;

        vhost_traffic_status_set_by_filter $requestCounter server/example.org/requestCounter;
        vhost_traffic_status_set_by_filter $requestCounterKR filter/country::example.org@KR/requestCounter;

        location /backend {
            vhost_traffic_status_set_by_filter $requestCounterB1 upstream@group/backend@10.10.10.11:80/requestCounter;
            proxy_pass http://backend;
        }
    }
}

Вышеуказанные настройки выглядят следующим образом:

  • $requestCounter
  • serverZones -> example.org -> requestCounter
  • $requestCounterKR
  • filterZones -> country::example.org -> KR -> requestCounter
  • $requestCounterB1
  • upstreamZones -> backend -> 10.0.10.11:80 -> requestCounter

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

JSON

Следующая информация о состоянии предоставляется в формате JSON:

Json используемый для состояния

/{status_uri}/format/json

/{status_uri}/control?cmd=status&...

  • hostName
  • Имя хоста.
  • moduleVersion
  • Версия модуля в формате {version}(|.dev.{commit}).
  • nginxVersion
  • Версия предоставленного.
  • loadMsec
  • Время загрузки процесса в миллисекундах.
  • nowMsec
  • Текущее время в миллисекундах.
  • connections
  • active
    • Текущее количество активных клиентских соединений.
  • reading
    • Общее количество читателей клиентских соединений.
  • writing
    • Общее количество писателей клиентских соединений.
  • waiting
    • Общее количество ожидающих клиентских соединений.
  • accepted
    • Общее количество принятых клиентских соединений.
  • handled
    • Общее количество обработанных клиентских соединений.
  • requests
    • Общее количество запрошенных клиентских соединений.
  • sharedZones
  • name
    • Имя общей памяти, указанное в конфигурации. (по умолчанию: vhost_traffic_status)
  • maxSize
    • Ограничение на максимальный размер общей памяти, указанное в конфигурации.
  • usedSize
    • Текущий размер общей памяти.
  • usedNode
    • Текущее количество узлов, использующих общую память. Приблизительный размер одного узла можно получить по следующей формуле: (usedSize / usedNode)
  • serverZones
  • requestCounter
    • Общее количество клиентских запросов, полученных от клиентов.
  • inBytes
    • Общее количество байт, полученных от клиентов.
  • outBytes
    • Общее количество байт, отправленных клиентам.
  • responses
    • 1xx, 2xx, 3xx, 4xx, 5xx
    • Количество ответов с кодами состояния 1xx, 2xx, 3xx, 4xx и 5xx.
    • miss
    • Количество промахов кэша.
    • bypass
    • Количество обходов кэша.
    • expired
    • Количество истекших кэшей.
    • stale
    • Количество устаревших кэшей.
    • updating
    • Количество обновляющихся кэшей.
    • revalidated
    • Количество переутвержденных кэшей.
    • hit
    • Количество попаданий в кэш.
    • scarce
    • Количество недостатков кэша.
  • requestMsecCounter
    • Число накопленного времени обработки запросов в миллисекундах.
  • requestMsec
    • Среднее время обработки запросов в миллисекундах.
  • requestMsecs
    • times
    • Время в миллисекундах на время обработки запросов.
    • msecs
    • Время обработки запросов в миллисекундах.
  • requestBuckets
    • msecs
    • Значения ведер гистограммы, установленные директивой vhost_traffic_status_histogram_buckets.
    • counters
    • Кумулятивные значения, для которых каждое значение ведра больше или равно времени обработки запроса.
  • filterZones
  • Обеспечивает те же поля, что и serverZones, за исключением того, что включены имена групп.
  • upstreamZones
  • server
    • Адрес сервера.
  • requestCounter
    • Общее количество клиентских соединений, перенаправленных на этот сервер.
  • inBytes
    • Общее количество байт, полученных от этого сервера.
  • outBytes
    • Общее количество байт, отправленных на этот сервер.
  • responses
    • 1xx, 2xx, 3xx, 4xx, 5xx
    • Количество ответов с кодами состояния 1xx, 2xx, 3xx, 4xx и 5xx.
  • requestMsecCounter
    • Количество накопленного времени обработки запросов, включая upstream, в миллисекундах.
  • requestMsec
    • Среднее время обработки запросов, включая upstream, в миллисекундах.
  • requestMsecs
    • times
    • Время в миллисекундах на время обработки запросов.
    • msecs
    • Время обработки запросов, включая upstream, в миллисекундах.
  • requestBuckets
    • msecs
    • Значения ведер гистограммы, установленные директивой vhost_traffic_status_histogram_buckets.
    • counters
    • Кумулятивные значения, для которых каждое значение ведра больше или равно времени обработки запроса, включая upstream.
  • responseMsecCounter
    • Количество накопленного времени обработки только upstream ответов в миллисекундах.
  • responseMsec
    • Среднее время обработки только upstream ответов в миллисекундах.
  • responseMsecs
    • times
    • Время в миллисекундах на время обработки ответов.
    • msecs
    • Время обработки только upstream ответов в миллисекундах.
  • responseBuckets
    • msecs
    • Значения ведер гистограммы, установленные директивой vhost_traffic_status_histogram_buckets.
    • counters
    • Кумулятивные значения, для которых каждое значение ведра больше или равно времени обработки только upstream ответов.
  • weight
    • Текущая настройка weight для сервера.
  • maxFails
    • Текущая настройка max_fails для сервера.
  • failTimeout
    • Текущая настройка fail_timeout для сервера.
  • backup
    • Текущая настройка backup для сервера.
  • down
    • Текущая настройка down для сервера. В основном, это просто отметка о том, что сервер из ngx_http_upstream_module отключен (например, server backend3.example.com down), а не фактическое состояние upstream сервера. Это изменится на фактическое состояние, если вы включите директиву upstream zone.
  • cacheZones
  • maxSize
    • Ограничение на максимальный размер кэша, указанное в конфигурации. Если max_size в директиве proxy_cache_path не указано, по умолчанию используется значение, зависящее от системы, NGX_MAX_OFF_T_VALUE. Другими словами, это значение из nginx, а не то, что я указал.
  • usedSize
    • Текущий размер кэша. Это значение берется из nginx, как и вышеуказанное значение maxSize.
  • inBytes
    • Общее количество байт, полученных из кэша.
  • outBytes
    • Общее количество байт, отправленных из кэша.
  • responses
    • miss
    • Количество промахов кэша.
    • bypass
    • Количество обходов кэша.
    • expired
    • Количество истекших кэшей.
    • stale
    • Количество устаревших кэшей.
    • updating
    • Количество обновляющихся кэшей.
    • revalidated
    • Количество переутвержденных кэшей.
    • hit
    • Количество попаданий в кэш.
    • scarce
    • Количество недостатков кэша.

Json используемый для управления

/{status_uri}/control?cmd=reset&...

/{status_uri}/control?cmd=delete&...

  • processingReturn
  • Результат true или false.
  • processingCommandString
  • Запрошенная строка команды.
  • processingGroupString
  • Запрошенная строка группы.
  • processingZoneString
  • Запрошенная строка зоны.
  • processingCounts
  • Фактическое количество обработки.

Переменные

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

  • $vts_request_counter
  • Общее количество клиентских запросов, полученных от клиентов.
  • $vts_in_bytes
  • Общее количество байт, полученных от клиентов.
  • $vts_out_bytes
  • Общее количество байт, отправленных клиентам.
  • $vts_1xx_counter
  • Количество ответов со статус-кодами 1xx.
  • $vts_2xx_counter
  • Количество ответов со статус-кодами 2xx.
  • $vts_3xx_counter
  • Количество ответов со статус-кодами 3xx.
  • $vts_4xx_counter
  • Количество ответов со статус-кодами 4xx.
  • $vts_5xx_counter
  • Количество ответов со статус-кодами 5xx.
  • $vts_cache_miss_counter
  • Количество промахов кэша.
  • $vts_cache_bypass_counter
  • Количество обходов кэша.
  • $vts_cache_expired_counter
  • Количество истекших значений кэша.
  • $vts_cache_stale_counter
  • Количество устаревших значений кэша.
  • $vts_cache_updating_counter
  • Количество обновлений кэша.
  • $vts_cache_revalidated_counter
  • Количество повторно подтвержденных значений кэша.
  • $vts_cache_hit_counter
  • Количество попаданий в кэш.
  • $vts_cache_scarce_counter
  • Количество дефицита кэша.
  • $vts_request_time_counter
  • Общее количество времени обработки запросов.
  • $vts_request_time
  • Среднее время обработки запросов.

Ограничение

Он способен ограничивать общий трафик для каждого хоста с помощью директивы vhost_traffic_status_limit_traffic. Он также может ограничивать весь трафик с помощью директивы vhost_traffic_status_limit_traffic_by_set_key. Когда лимит превышен, сервер вернет ошибку 503 (Служба временно недоступна) в ответ на запрос. Код возврата может быть изменен.

Ограничить трафик для сервера

http {

    vhost_traffic_status_zone;

    ...

    server {

        server_name *.example.org;

        vhost_traffic_status_limit_traffic in:64G;
        vhost_traffic_status_limit_traffic out:1024G;

        ...
    }
}
  • Ограничить входящий/исходящий общий трафик на *.example.org до 64G и 1024G соответственно. Это работает индивидуально для каждого домена, если включена директива vhost_traffic_status_filter_by_host.

Ограничить трафик для фильтра

http {
    geoip_country /usr/share/GeoIP/GeoIP.dat;

    vhost_traffic_status_zone;

    ...

    server {

        server_name example.org;

        vhost_traffic_status_filter_by_set_key $geoip_country_code country::$server_name;
        vhost_traffic_status_limit_traffic_by_set_key FG@country::$server_name@US out:1024G;
        vhost_traffic_status_limit_traffic_by_set_key FG@country::$server_name@CN out:2048G;

        ...

    }
}
  • Ограничить общий трафик, поступающий в США и КНР на example.org, до 1024G и 2048G соответственно.

Ограничить трафик для upstream

http {

    vhost_traffic_status_zone;

    ...

    upstream backend {
        server 10.10.10.17:80;
        server 10.10.10.18:80;
    }

    server {

        server_name example.org;

        location /backend {
            vhost_traffic_status_limit_traffic_by_set_key UG@backend@10.10.10.17:80 in:512G;
            vhost_traffic_status_limit_traffic_by_set_key UG@backend@10.10.10.18:80 in:1024G;
            proxy_pass http://backend;
        }

        ...

    }
}
  • Ограничить общий трафик, поступающий в upstream backend на example.org, до 512G и 1024G для каждого пира.

Предостережения: Трафик - это накопленный объем передачи или счетчик, а не скорость передачи данных.

Сценарии использования

Он способен вычислять определенные пользователем индивидуальные статистические данные, используя директиву vhost_traffic_status_filter_by_set_key.

Для вычисления трафика для отдельной страны с использованием GeoIP

http {
    geoip_country /usr/share/GeoIP/GeoIP.dat;

    vhost_traffic_status_zone;
    vhost_traffic_status_filter_by_set_key $geoip_country_code country::*;

    ...

    server {

        ...

        vhost_traffic_status_filter_by_set_key $geoip_country_code country::$server_name;

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}
  • Вычисление трафика для отдельной страны среди всех серверных групп.
  • Вычисление трафика для отдельной страны для каждой из серверных групп.

В основном, изображения флагов стран встроены в HTML. Изображение флага страны включается, если строка country присутствует в названии группы, который является вторым аргументом директивы vhost_traffic_status_filter_by_set_key.

Для вычисления трафика для отдельного дискового объема

http {
    vhost_traffic_status_zone;

    ...

    server {

        ...

        location ~ ^/storage/(.+)/.*$ {
            set $volume $1;
            vhost_traffic_status_filter_by_set_key $volume storage::$server_name;
        }

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}
  • Вычисление трафика для отдельного дискового объема, совпадающего с регулярным выражением директивы location.

Для вычисления трафика для отдельного пользовательского агента

http {
    vhost_traffic_status_zone;

    map $http_user_agent $filter_user_agent {
        default 'unknown';
        ~iPhone ios;
        ~Android android;
        ~(MSIE|Mozilla) windows;
    }

    vhost_traffic_status_filter_by_set_key $filter_user_agent agent::*;

    ...

    server {

        ...

        vhost_traffic_status_filter_by_set_key $filter_user_agent agent::$server_name;

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}
  • Вычисление трафика для отдельного http_user_agent

Для вычисления трафика по детальному коду http статуса

http {
    vhost_traffic_status_zone;

    server {

        ...

        vhost_traffic_status_filter_by_set_key $status $server_name;

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}
  • Вычисление трафика по детальному http статус коду

Предостережения: Переменная $status доступна в nginx-(1.3.2, 1.2.2).

Для вычисления трафика для динамического dns

Если домен имеет несколько DNS A записей, вы можете вычислить трафик для отдельных IP-адресов для домена, используя функцию фильтрации или переменную в proxy_pass.

http {
    vhost_traffic_status_zone;

    upstream backend {
        elb.example.org:80;
    }

    ...

    server {

        ...

        location /backend {
            vhost_traffic_status_filter_by_set_key $upstream_addr upstream::backend;
            proxy_pass backend;
        }
    }
}
  • Вычисление трафика для отдельных IP-адресов для домена elb.example.org. Если у elb.example.org есть несколько DNS A записей, будут отображены все IP-адреса в filterZones. В вышеуказанных настройках, когда NGINX запускается или обновляет свою конфигурацию, он запрашивает DNS сервер для разрешения домена, и DNS A записи кешируются в памяти. Поэтому DNS A записи не изменяются в памяти, даже если DNS A записи изменяются администратором DNS, если только NGINX не перезапускается или не перезагружается.
http {
    vhost_traffic_status_zone;

    resolver 10.10.10.53 valid=10s

    ...

    server {

        ...

        location /backend {
            set $backend_server elb.example.org;
            proxy_pass http://$backend_server;
        }
    }
}
  • Вычисление трафика для отдельных IP-адресов для домена elb.example.org. Если A запись DNS elb.example.org изменяется, будет отображен как старый, так и новый IP в ::nogroups. В отличие от первой настройки группы upstream, вторая настройка работает хорошо, даже если A записи DNS изменяются администратором DNS.

Предостережения: Пожалуйста, ознакомьтесь с дополнительной информацией о DNS NGINX в статье dns-service-discovery-nginx-plus.

Для вычисления трафика, за исключением страницы состояния

http {
    vhost_traffic_status_zone;

    ...

    server {

        ...

        location /status {
            vhost_traffic_status_bypass_limit on;
            vhost_traffic_status_bypass_stats on;
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}

Для постоянного хранения статистических данных

http {
    vhost_traffic_status_zone;
    vhost_traffic_status_dump /var/log/nginx/vts.db;

    ...

    server {

        ...

    }
}
  • Директива vhost_traffic_status_dump обеспечивает постоянное хранение статистических данных, даже если система была перезагружена или nginx был перезапущен. Пожалуйста, смотрите директиву vhost_traffic_status_dump для подробного использования.

Настройка

Настройка после установки модуля

  1. Вам нужно изменить строку {{uri}} на ваш статусный URI в status.template.html следующим образом: 

    shell> vi share/status.template.html

    var vtsStatusURI = "yourStatusUri/format/json", vtsUpdateInterval = 1000;

  2. Затем настройте и скопируйте status.template.html в корневую директорию сервера следующим образом: 

    shell> cp share/status.template.html /usr/share/nginx/html/status.html

  3. Настройте nginx.conf 

       server {
       server_name example.org;
       root /usr/share/nginx/html;

       # Перенаправить запросы с / на /status.html
       location = / {
           return 301 /status.html;
       }

       location = /status.html {}

       # Всё, что начинается с /status (кроме /status.html) обрабатывается
       # обработчиком статуса
       location /status {
           vhost_traffic_status_display;
           vhost_traffic_status_display_format json;
       }
   }

  4. Доступ к вашему html. 

    http://example.org/status.html

Настройка до установки модуля

  1. Измените share/status.template.html (не меняйте строку {{uri}})

  2. Восстановите файл ngx_http_vhost_traffic_status_module_html.h следующим образом: 

    shell> cd util
shell> ./tplToDefine.sh ../share/status.template.html > ../src/ngx_http_vhost_traffic_status_module_html.h

  3. Добавьте модуль в конфигурацию сборки, добавив --add-module=/path/to/nginx-module-vts

  4. Соберите двоичный файл nginx.

  5. Установите двоичный файл nginx.

Директивы

draw_io_vts_diagram

vhost_traffic_status

- -
Синтаксис vhost_traffic_status \<on|off>
По умолчанию off
Контекст http, server, location

Описание: Включает или отключает работу модуля. Если вы установите директиву vhost_traffic_status_zone, она автоматически включится.

vhost_traffic_status_zone

- -
Синтаксис vhost_traffic_status_zone [shared:name:size]
По умолчанию shared:vhost_traffic_status:1m
Контекст http

Описание: Устанавливает параметры для зоны общей памяти, которая будет хранить состояния для различных ключей. Кэш разделяется между всеми рабочими процессами. В большинстве случаев размер общей памяти, используемой модулем nginx-module-vts, значительно не увеличивается. Размер общей памяти увеличивается довольно сильно при использовании директивы vhost_traffic_status_filter_by_set_key, но если ключи фильтра фиксированы (например, общее количество кодов стран составляет около 240), он не увеличивается постоянно.

Если вы используете директиву vhost_traffic_status_filter_by_set_key, установите ее следующим образом:

  • Установите больше 32M по умолчанию. (vhost_traffic_status_zone shared:vhost_traffic_status:32m)
  • Если в error_log выводится сообщение ("ngx_slab_alloc() failed: no memory in vhost_traffic_status_zone"), увеличьте значение более чем на (usedSize * 2).

vhost_traffic_status_dump

- -
Синтаксис vhost_traffic_status_dump path [period]
По умолчанию -
Контекст http

Описание: Включает дамп статистических данных и восстановление. Путь path - это местоположение для дампа статистических данных (например, /var/log/nginx/vts.db). Период period - это время цикла резервного копирования (по умолчанию: 60s). Он будет забэкаплен немедленно независимо от цикла резервного копирования, если nginx завершится по сигналу (SIGKILL).

vhost_traffic_status_display

- -
Синтаксис vhost_traffic_status_display
По умолчанию -
Контекст http, server, location

Описание: Включает или отключает дисплейный обработчик модуля.

vhost_traffic_status_display_format

- -
Синтаксис vhost_traffic_status_display_format \<json|html|jsonp|prometheus>
По умолчанию json
Контекст http, server, location

Описание: Устанавливает формат вывода обработчика отображения. Если вы установите json, будет дан ответ в виде документа JSON. Если вы установите html, будет дан ответ с встроенной живой панелью в формате HTML. Если вы установите jsonp, будет дан ответ с функцией обратного вызова JSONP (по умолчанию: ngx_http_vhost_traffic_status_jsonp_callback). Если вы установите prometheus, будет дан ответ с документом prometheus.

vhost_traffic_status_display_jsonp

- -
Синтаксис vhost_traffic_status_display_jsonp callback
По умолчанию ngx_http_vhost_traffic_status_jsonp_callback
Контекст http, server, location

Описание: Устанавливает имя обратного вызова для JSONP.

vhost_traffic_status_display_sum_key

- -
Синтаксис vhost_traffic_status_display_sum_key name
По умолчанию *
Контекст http, server, location

Описание: Устанавливает строку суммы ключа в поле JSON serverZones. Строка суммы по умолчанию - это "*".

vhost_traffic_status_filter

- -
Синтаксис vhost_traffic_status_filter \<on|off>
По умолчанию on
Контекст http, server, location

Описание: Включает или отключает функции фильтрации.

vhost_traffic_status_filter_by_host

- -
Синтаксис vhost_traffic_status_filter_by_host \<on|off>
По умолчанию off
Контекст http, server, location

Описание: Включает или отключает ключи по полю заголовка Host. Если вы установите on, и директива server_name nginx установлена на несколько или с подстановочным знаком, начинающимся с символа , например, “.example.org”, и будет запрашиваться сервер с именем хоста, таким как (a|b|c).example.org или *.example.org, тогда JSON serverZones будет распечатан следующим образом:

server {
  server_name *.example.org;
  vhost_traffic_status_filter_by_host on;

  ...

}

  ...
  "serverZones": {
      "a.example.org": {
      ...
      },
      "b.example.org": {
      ...
      },
      "c.example.org": {
      ...
      }
      ...
   },
   ...

Это обеспечивает ту же функциональность, что и установка vhost_traffic_status_filter_by_set_key $host.

vhost_traffic_status_filter_by_set_key

- -
Синтаксис vhost_traffic_status_filter_by_set_key key [name]
По умолчанию -
Контекст http, server, location

Описание: Включает ключи по пользовательской переменной. Ключ key - это строка ключа для расчета трафика. name - это строка группы для расчета трафика. key и name могут содержать переменные, такие как $host, $server_name. Группа name принадлежит filterZones, если указана. Группа key принадлежит serverZones, если не указаны вторичный аргумент name. Пример с модулем geoip представлен ниже:

server {
  server_name example.org;
  vhost_traffic_status_filter_by_set_key $geoip_country_code country::$server_name;

  ...

}

  ...
  "serverZones": {
  ...
  },
  "filterZones": {
      "country::example.org": {
          "KR": {
              "requestCounter":...,
              "inBytes":...,
              "outBytes":...,
              "responses":{
                  "1xx":...,
                  "2xx":...,
                  "3xx":...,
                  "4xx":...,
                  "5xx":...,
                  "miss":...,
                  "bypass":...,
                  "expired":...,
                  "stale":...,
                  "updating":...,
                  "revalidated":...,
                  "hit":...,
                  "scarce":...
              },
              "requestMsecCounter":...,
              "requestMsec":...,
              "requestMsecs":{
                  "times":[...],
                  "msecs":[...]
              },
          },
          "US": {
          ...
          },
          ...
      },
      ...
  },
  ...

vhost_traffic_status_filter_check_duplicate

- -
Синтаксис vhost_traffic_status_filter_check_duplicate \<on|off>
По умолчанию on
Контекст http, server, location

Описание: Включает или отключает дедупликацию vhost_traffic_status_filter_by_set_key. Обрабатывается только одно из дублирующих значений (key + name) в каждой директиве (http, server, location), если эта опция включена.

vhost_traffic_status_filter_max_node

- -
Синтаксис vhost_traffic_status_filter_max_node number [string ...]
По умолчанию 0
Контекст http

Описание: Включает ограничение на размер фильтра с использованием указанных значений number и string. Если number превышено, существующие узлы удаляются по алгоритму LRU. Аргумент number - это размер узла, который будет ограничен. Значение по умолчанию 0 не ограничивает фильтры. Один узел - это объект в filterZones в JSON документе. Аргументы string - это значения строк, которые соответствуют строковым значениям группы, установленным директивой vhost_traffic_status_filter_by_set_key. Даже если совпадает только первая часть, соответствие успешно, как в регулярном выражении /^string.*/. По умолчанию, если вы не задаете аргументы string, они применяются для всех фильтров.

Примеры:

$ vi nginx.conf

http {

    geoip_country /usr/share/GeoIP/GeoIP.dat;

    vhost_traffic_status_zone;

    # Все фильтры ограничены в общей сложности 16 узлов.
    # vhost_traffic_status_filter_max_node 16

    # Шаблоны групповых строк `/^uris.*/` и `/^client::ports.*/` ограничены в общей сложности 64 узла.
    vhost_traffic_status_filter_max_node 16 uris client::ports;

    ...

    server {

        server_name example.org;

        ...

        vhost_traffic_status_filter_by_set_key $uri uris::$server_name;
        vhost_traffic_status_filter_by_set_key $remote_port client::ports::$server_name;
        vhost_traffic_status_filter_by_set_key $geoip_country_code country::$server_name;

    }
}

$ for i in {0..1000}; do curl -H 'Host: example.org' -i "http://localhost:80/test$i"; done

screenshot-vts-filter-max-node

В приведенном выше примере шаблоны групповых строк /^uris.*/ и /^client::ports.*/ ограничены в общей сложности 16 узлов. Остальные фильтры, такие как country::.*, не ограничены.

vhost_traffic_status_limit

- -
Синтаксис vhost_traffic_status_limit \<on|off>
По умолчанию on
Контекст http, server, location

Описание: Включает или отключает функции ограничения.

vhost_traffic_status_limit_traffic

- -
Синтаксис vhost_traffic_status_limit_traffic member:size [code]
По умолчанию -
Контекст http, server, location

Описание: Включает ограничение трафика для указанного member. member - это строка члена для ограничения трафика. size - это размер (k/m/g) для ограничения трафика. code - это код, который вернуть в ответ на отклоненные запросы (по умолчанию: 503).

Доступные строки member следующие: * request * Общее количество клиентских запросов, полученных от клиентов. * in * Общее количество байт, полученных от клиентов. * out * Общее количество байт, отправленных клиентам. * 1xx * Количество ответов со статус-кодами 1xx. * 2xx * Количество ответов со статус-кодами 2xx. * 3xx * Количество ответов со статус-кодами 3xx. * 4xx * Количество ответов со статус-кодами 4xx. * 5xx * Количество ответов со статус-кодами 5xx. * cache_miss * Количество пропусков кэша. * cache_bypass * Количество обхождений кэша. * cache_expired * Количество истекших кэшей. * cache_stale * Количество устаревших кэшей. * cache_updating * Количество обновлений кэша. * cache_revalidated * Количество повторных проверок кэша. * cache_hit * Количество попаданий в кэш. * cache_scarce * Количество дефицита кэша.

vhost_traffic_status_limit_traffic_by_set_key

- -
Синтаксис vhost_traffic_status_limit_traffic_by_set_key key member:size [code]
По умолчанию -
Контекст http, server, location

Описание: Включает ограничение трафика для указанного key и member. key - это строка ключа для ограничения трафика. member - это строка члена для ограничения трафика. size - это размер (k/m/g) для ограничения трафика. code - это код, который вернуть в ответ на отклоненные запросы (по умолчанию: 503).

Синтаксис key следующий: * group@[subgroup@]name

Доступные строки group следующие: * NO * Группа сервера. * UA * Группа уникального upstream. * UG * Группа upstream (используйте subgroup). * CC * Группа кэша. * FG * Группа фильтров (используйте subgroup).

Доступные строки member следующие: * request * Общее количество клиентских запросов, полученных от клиентов. * in * Общее количество байт, полученных от клиентов. * out * Общее количество байт, отправленных клиентам. * 1xx * Количество ответов со статус-кодами 1xx. * 2xx * Количество ответов со статус-кодами 2xx. * 3xx * Количество ответов со статус-кодами 3xx. * 4xx * Количество ответов со статус-кодами 4xx. * 5xx * Количество ответов со статус-кодами 5xx. * cache_miss * Количество пропусков кэша. * cache_bypass * Количество обхождений кэша. * cache_expired * Количество истекших кэшей. * cache_stale * Количество устаревших кэшей. * cache_updating * Количество обновлений кэша. * cache_revalidated * Количество повторных проверок кэша. * cache_hit * Количество попаданий в кэш. * cache_scarce * Количество дефицита кэша.

member аналогично директиве vhost_traffic_status_limit_traffic.

vhost_traffic_status_limit_check_duplicate

- -
Синтаксис vhost_traffic_status_limit_check_duplicate \<on|off>
По умолчанию on
Контекст http, server, location

Описание: Включает или отключает дедупликацию vhost_traffic_status_limit_by_set_key. Обрабатывается только одно из дублирующих значений (member | key + member) в каждой директиве (http, server, location), если эта опция включена.

vhost_traffic_status_set_by_filter

- -
Синтаксис vhost_traffic_status_set_by_filter $variable group/zone/name
По умолчанию -
Контекст http, server, location, if

Описание: Получает указанное значение состояния, хранящееся в общей памяти. Он может получить почти все значения состояния, а полученное значение хранится в $variable, который является первым аргументом.

  • group
  • server
  • filter
  • upstream@alone
  • upstream@group
  • cache
  • zone
  • server
    • name
  • filter
    • filter_group@name
  • upstream@group
    • upstream_group@name
  • upstream@alone
    • @name
  • cache
    • name
  • name
  • requestCounter
    • Общее количество клиентских запросов, полученных от клиентов.
  • requestMsecCounter
    • Количество накопленного времени обработки запросов в миллисекундах.
  • requestMsec
    • Среднее время обработки запросов в миллисекундах.
  • responseMsecCounter
    • Количество накопленного времени обработки только ответов upstream в миллисекундах.
  • responseMsec
    • Среднее время обработки только ответов upstream в миллисекундах.
  • inBytes
    • Общее количество байт, полученных от клиентов.
  • outBytes
    • Общее количество байт, отправленных клиентам.
  • 1xx, 2xx, 3xx, 4xx, 5xx
    • Количество ответов со статус-кодами 1xx, 2xx, 3xx, 4xx и 5xx.
  • cacheMaxSize
    • Ограничение на максимальный размер кэша, указанное в конфигурации.
  • cacheUsedSize
    • Текущий размер кэша.
  • cacheMiss
    • Количество пропусков кэша.
  • cacheBypass
    • Количество обхождений кэша.
  • cacheExpired
    • Количество истекших кэшей.
  • cacheStale
    • Количество устаревших кэшей.
  • cacheUpdating
    • Количество обновлений кэша.
  • cacheRevalidated
    • Количество повторных проверок кэша.
  • cacheHit
    • Количество попаданий в кэш.
  • cacheScarce
    • Количество дефицита кэша.
  • weight
    • Текущая настройка веса сервера.
  • maxFails
    • Текущая настройка max_fails сервера.
  • failTimeout
    • Текущая настройка fail_timeout сервера.
  • backup
    • Текущая настройка резервирования сервера (0|1).
  • down
    • Текущая настройка состояния сервера (0|1).

Предостережения: name чувствителен к регистру. Все возвращаемые значения имеют целочисленный тип.

Примеры: * requestCounter в serverZones * vhost_traffic_status_set_by_filter $requestCounter server/example.org/requestCounter * requestCounter в фильтровых зонах * vhost_traffic_status_set_by_filter $requestCounter filter/country::example.org@KR/requestCounter * requestCounter в upstreamZones * vhost_traffic_status_set_by_filter $requestCounter upstream@group/backend@10.10.10.11:80/requestCounter * requestCounter в upstreamZones::nogroups * vhost_traffic_status_set_by_filter $requestCounter upstream@alone/10.10.10.11:80/requestCounter * cacheHit в cacheZones * vhost_traffic_status_set_by_filter $cacheHit cache/my_cache_name/cacheHit

vhost_traffic_status_average_method

- -
Синтаксис vhost_traffic_status_average_method \<AMM|WMA> [period]
По умолчанию AMM 60s
Контекст http, server, location

Описание: Устанавливает метод, который является формулой для расчета среднего времени обработки ответов. Период period - это эффективное время значений, используемых для расчета среднего (по умолчанию: 60s). Если period установлено на 0, эффективное время игнорируется. В этом случае отображается последнее среднее значение, даже если запросов не было, и после истечения времени. Соответствующие значения - это requestMsec и responseMsec в JSON.

vhost_traffic_status_histogram_buckets

- -
Синтаксис vhost_traffic_status_histogram_buckets second ...
По умолчанию -
Контекст http, server, location

Описание: Устанавливает ведра для наблюдения, используемые в гистограммах. По умолчанию, если вы не установите эту директиву, она не будет работать. second может быть указано в десятичных дробях с минимальным значением 0.001 (1ms). Максимальный размер ведер - 32. Если этого значения недостаточно для вас, измените NGX_HTTP_VHOST_TRAFFIC_STATUS_DEFAULT_BUCKET_LEN в src/ngx_http_vhost_traffic_status_node.h.

Примеры: * vhost_traffic_status_histogram_buckets 0.005 0.01 0.05 0.1 0.5 1 5 10 * Ведра наблюдения: [5ms 10ms 50ms 100ms 500ms 1s 5s 10s]. * vhost_traffic_status_histogram_buckets 0.005 0.01 0.05 0.1 * Ведра наблюдения: [5ms 10ms 50ms 100ms].

Предостережения: По умолчанию, если вы не установите эту директиву, статистика гистограммы не работает. Восстановленные гистограммы директивой vhost_traffic_status_dump не подлежат влиянию изменений ведер в директиве vhost_traffic_status_histogram_buckets. Поэтому вы должны сначала удалить зону или файл дампа перед изменением ведер в директиве vhost_traffic_status_histogram_buckets. Аналогично, удалите файл дампа при первом использовании гистограммы.

vhost_traffic_status_bypass_limit

- -
Синтаксис vhost_traffic_status_bypass_limit \<on|off>
По умолчанию off
Контекст http, server, location

Описание: Включает или отключает обход директив vhost_traffic_status_limit. Функции ограничения обходятся, если эта опция включена. Это в основном полезно, если вы хотите подключиться к веб-странице состояния, такой как /status, независимо от директив vhost_traffic_status_limit, как показано ниже:

http {
    vhost_traffic_status_zone;

    ...

    server {

        ...

        location /status {
            vhost_traffic_status_bypass_limit on;
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}

vhost_traffic_status_bypass_stats

- -
Синтаксис vhost_traffic_status_bypass_stats \<on|off>
По умолчанию off
Контекст http, server, location

Описание: Включает или отключает обход vhost_traffic_status. Функции статистики трафика обходятся, если эта опция включена. Другими словами, это исключено из статистики трафика. Это в основном полезно, если вы хотите игнорировать свой запрос на веб-странице состояния, такой как /status, как показано ниже:

http {
    vhost_traffic_status_zone;

    ...

    server {

        ...

        location /status {
            vhost_traffic_status_bypass_stats on;
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}

vhost_traffic_status_stats_by_upstream

- -
Синтаксис vhost_traffic_status_stats_by_upstream \<on|off>
По умолчанию on
Контекст http

Описание: Включает или отключает статистику upstreamZone. upstreamZone в функциях статистики трафика обходится, если эта опция отключена. Другими словами, это исключено из статистики трафика. Это в основном полезно, если вы хотите отключить сбор статистики для upstream серверов, чтобы снизить нагрузку на процессор.

http {
    vhost_traffic_status_zone;
    vhost_traffic_status_stats_by_upstream off;

    proxy_cache_path /var/cache/nginx keys_zone=zone1:1m max_size=1g inactive=24h;
    upstream backend {
       ...
    }
    ...

    server {

        ...

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
        location /backend {
            proxy_cache zone1;
            proxy_pass http://backend;
        }
    }
}

Выпуски

Чтобы подготовить выпуск, создайте PR для записи в журнал изменений с помощью git-chglog

version="v0.2.0"
git checkout -b "cut-${version}"
git-chglog -o CHANGELOG.md --next-tag "${version}"
git add CHANGELOG.md
sed -i "s/NGX_HTTP_VTS_MODULE_VERSION \".*/NGX_HTTP_VTS_MODULE_VERSION \"${version}\"/" src/ngx_http_vhost_traffic_status_module.h
git add src/ngx_http_vhost_traffic_status_module.h
git-chglog -t .chglog/RELNOTES.tmpl --next-tag "${version}" "${version}" | git commit -F-

После слияния PR создайте новый тег и выпуск на GitHub Releases.

См. также