live_kmp_read_timeout

Директива `live_kmp_read_timeout` задаёт длительность ожидания при чтении потоков Kaltura Media Protocol (KMP).

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

Описание

Директива live_kmp_read_timeout задаёт максимально допустимое время, в течение которого сервер NGINX будет ожидать при попытке прочитать данные из потока Kaltura Media Protocol (KMP). Это особенно важно для того, чтобы чтение потоков не зависало бесконечно, что может стать проблемой в производственной среде, где критичны надёжность потоков и отзывчивость сервера. Директива принимает один аргумент — значение времени в секундах, что позволяет администраторам задать, как долго сервер должен блокироваться в ожидании данных, прежде чем отказаться и закрыть соединение.

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

Ещё один аспект — контекст этой директивы; её можно использовать как в контексте 'stream', так и в контексте 'stream server'. Такая гибкость позволяет точно контролировать поведение чтения потоков на разных уровнях иерархии конфигурации NGINX.

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

stream {
    server {
        listen 1935;
        live_kmp_read_timeout 30s;
    }
}

Установка слишком малого значения таймаута может привести к частым разрывам соединения с потоком, тогда как слишком большое значение может снизить производительность сервера из-за простаивающих соединений. Обязательно проведите тестирование производительности и отрегулируйте параметры соответственно.

Эта директива применяется только к KMP-потокам; её использование в контекстах, не связанных с KMP, может привести к неопределённому поведению.

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