kmp_ctrl_retries

Директива `kmp_ctrl_retries` контролирует количество попыток повтора, когда контроллер Kaltura Media Protocol (KMP) не может связаться с медиакомпонентом.

Синтаксисkmp_ctrl_retries number;
По умолчанию3
Контекст
Аргументы1

Описание

Директива kmp_ctrl_retries является частью Kaltura Media Framework Common NGINX Module, который используется для управления распределёнными медиакомпонентами в потоковой архитектуре. Когда контроллер KMP отправляет HTTP-запросы медиакомпонентам, он может столкнуться с ошибками по разным причинам, таким как нестабильность сети или недоступность компонентов. Директива kmp_ctrl_retries позволяет пользователям указать, сколько раз контроллер должен пытаться повторить запрос, прежде чем считать операцию неудачной.

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

Настройка этой директивы должна выполняться исходя из надёжности базовых медиакомпонентов и сетевой инфраструктуры. Рекомендуется провести тестирование, чтобы найти оптимальное число повторов, которое балансирует между устойчивостью и производительностью.

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

kmp_ctrl_retries 5;

Установка слишком большого количества повторных попыток может привести к увеличению времени отклика.

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

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