nchan_subscriber_info

Директива `nchan_subscriber_info` используется для настройки обработки информации о подписчиках в Nchan — сервере pub/sub для NGINX.

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

Описание

Директива nchan_subscriber_info позволяет location отвечать информацией о текущих подписчиках на channel. Она работает без дополнительных аргументов, то есть достаточно просто объявить её, чтобы она вступила в силу. Когда эта директива включена в контексте location, она позволяет Nchan возвращать данные о каждом подписчике, такие как состояние их соединения и сообщения, которые они в данный момент получают. Это может быть полезно для отладки или мониторинга активности подписчиков. Стоит отметить, что обработка этой информации выполняется асинхронно, что гарантирует отсутствие влияния на производительность сервера даже при запросе данных о подписчиках.

В контексте масштабируемости знание о количестве подключенных подписчиков или других атрибутах их соединений помогает администраторам оценивать нагрузку и производительность системы pub/sub. Эта директива не изменяет основную функциональность публикации или получения сообщений, а служит дополнительным инструментом для исследования внутреннего состояния. Она отлично подходит в составе модуля Nchan, который стремится обеспечить гибкие решения для обмена сообщениями в режиме реального времени для веб-приложений, позволяя разработчикам получать представление о текущих коммуникациях между издателями и подписчиками.

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

location /subscribe {
    nchan_subscriber_info;
    nchan_subscriber_channel_id my_channel;
}

Убедитесь, что директива nchan_subscriber_info определена в допустимом контексте location.

Помните, что эта директива не принимает никаких параметров, поэтому указание аргументов приведёт к ошибкам конфигурации.

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