nchan_eventsource_ping_interval

Устанавливает интервал отправки ping-сообщений клиентам, использующим соединения EventSource.

Синтаксисnchan_eventsource_ping_interval time;
По умолчаниюnone
Контекстserver, location, if in location
Аргументы1

Описание

Директива nchan_eventsource_ping_interval задаёт интервал времени, через который отправляются ping-сообщения по соединениям EventSource для поддержания соединения активным. Когда клиенты подключены через EventSource, сервер поддерживает открытое соединение для отправки обновлений клиентам. Если соединение некоторое время простаивает, клиенты могут отключиться, поэтому периодическая отправка ping-сообщений обеспечивает сохранение соединения активным и работоспособным. Данная директива принимает один аргумент — значение времени, указывающее интервал между последовательными ping-сообщениями клиенту.

На практике эта директива помогает поддерживать здоровье соединения при минимальном взаимодействии с клиентом. В зависимости от заданного значения вы можете настроить частоту этих ping-сообщений, чтобы найти баланс между использованием ресурсов и доступностью соединения. Например, установка более короткого интервала может предотвратить разрывы из‑за сетевых проблем, но также привести к повышенной нагрузке на сервер и клиент. Напротив, более длинный интервал может экономить ресурсы, но увеличить риск «молчащих» отключений.

Эта директива особенно полезна при создании приложений реального времени, которые зависят от поддержания открытых соединений WebSockets или EventSource без прерываний в периоды высокой нагрузки или простоя. Её можно использовать в различных контекстах, таких как server, location, а также внутри условий if в блоке location, что даёт гибкость в соответствии с конкретными потребностями вашего приложения.

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

location /events {
    nchan_eventsource_ping_interval 30s;
    nchan_subscriber_channel_id your_channel;
}

Установка чрезмерно малого интервала может привести к увеличению нагрузки на сервер.

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

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