push_stream_channels_statistics

Активирует статистику каналов для NGINX Push Stream module.

Синтаксисpush_stream_channels_statistics;
По умолчаниюnone
Контекстlocation
Аргументыnone

Описание

Директива push_stream_channels_statistics используется в NGINX Push Stream module для включения сбора и получения статистики по различным каналам. Это особенно полезно для мониторинга, так как позволяет отслеживать данные, такие как количество активных подписчиков на канал, количество отправленных сообщений и другие соответствующие метрики. Когда директива включена в location block, она преобразует этот endpoint в endpoint отчёта статистики каналов, который может выводить данные в JSON формате на основе параметров запроса.

Директива не принимает аргументов и добавляется в location context, то есть её область действия ограничена конкретными шаблонами URL, определёнными в конфигурации сервера. После активации директивы в заданном location пользователи могут получать статистику каналов с помощью определённых параметров запроса, например указывая channel ID или запрашивая сводную статистику по всем каналам. Эта функциональность помогает администраторам получить представление об активности каналов и использовании ресурсов для повышения общей производительности приложений, использующих возможности push stream.

Пример конфига

server {
    location /channels-stats {
        push_stream_channels_statistics;
        push_stream_channels_path $arg_id;
    }
}

Убедитесь, что директива используется внутри блока location; она зависит от контекста и не будет корректно работать вне этого контекста.

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

← Ко всем директивам