nchan_eventsource_ping_event
Устанавливает интервал ping-событий для соединений EventSource в модуле Nchan для NGINX.
Описание
Директива nchan_eventsource_ping_event задаёт интервал, с которым ping-события отправляются клиентам для соединений EventSource (SSE). Это особенно важно для поддержания открытого соединения с клиентами и предотвращения таймаутов из‑за бездействия. Установка этой директивы позволяет администраторам задать, как часто сервер должен отправлять ping-сообщение подключённым клиентам EventSource, гарантируя, что клиенты осведомлены о статусе соединения.
При задании значение в nchan_eventsource_ping_event определяет частоту этих ping-сообщений в секундах. Если клиент не отправляет сообщений в установленный промежуток времени или сервер не получает связи, соединение может считаться устаревшим и быть закрыто, поэтому правильная настройка этой директивы важна для приложений, зависящих от передачи данных в реальном времени. Механизм ping особенно полезен для долговременных соединений: он лучше синхронизирует взаимодействие сервера и клиента и обеспечивает своевременное обнаружение разрывов соединения обеими сторонами.
Чтобы применить nchan_eventsource_ping_event, включите её в конфигурационные файлы NGINX в контексте server или location. Установите значение, исходя из требований вашего приложения, учитывая баланс между потреблением ресурсов и стабильностью соединений для пользователей.
Пример конфига
server {
location /events {
nchan_eventsource_ping_event 30;
nchan_pubsub;
}
}Установка слишком малого значения ping interval может привести к избыточной нагрузке на сервер из-за частых ping messages.
Если ping interval слишком велик, клиенты могут терять соединение из-за timeout со стороны intermediate proxies или firewalls.