ts_kmp_ctrl_retry_interval

Sets the retry interval for the Kaltura media framework controller operations in NGINX.

Syntaxts_kmp_ctrl_retry_interval time;
Default5s
Contextstream, stream server
Arguments1

Description

The ts_kmp_ctrl_retry_interval directive specifies the duration between retry attempts for controller operations within the Kaltura Media Framework. It is essential in scenarios where the controller needs to communicate with various components, such as the transcoder or media publishers, and encounters transient errors during these communications. This directive provides control over the time the framework waits before attempting to resend commands or fetch status updates in case of failures. By configuring this directive properly, administrators can mitigate issues related to temporary network disruptions or component overloads, thereby ensuring more robust media processing workflows.

The directive requires a single argument that designates the interval duration. This value should be set according to the expected latency and failure recovery needs of the specific environment. Setting the interval too short may lead to rapid successive attempts that do not allow enough time for recovery, while setting it too long can delay critical operations that could otherwise succeed with earlier retries. It’s crucial to test and tune this value to fit the particular media streaming infrastructure and its response characteristics.

Config Example

stream {
    server {
        ts_kmp_ctrl_retry_interval 10s;
    }
}

Ensure the interval is appropriate for your network latency.

Setting the interval too low may flood the controller with requests.

Make sure to check for potential performance impacts on the media pipeline.

← Back to all directives