kmp_idle_timeout

The `kmp_idle_timeout` directive specifies the duration of inactivity before a Kaltura Media Protocol connection is considered idle and eligible for closure.

Syntaxkmp_idle_timeout time;
Defaultnone
Context
Arguments1

Description

The kmp_idle_timeout directive is used within the Kaltura Media Framework to manage the lifecycle of connections established for media streaming via the Kaltura Media Protocol (KMP). When a connection is established for media streaming, it enters a state of activity during which data transfer occurs. If there is no activity detected on the connection for a specified duration defined by the kmp_idle_timeout value, the connection is deemed idle.

This timeout helps in resource management by automatically closing inactive connections, which can free up server resources and limit the number of active connections that might otherwise remain open indefinitely. The directive accepts a single argument that represents the timeout duration and can be specified in time variables such as seconds, minutes, or hours. Properly configuring this timeout is crucial to balancing resource efficiency with user experience, as setting it too low may lead to unnecessary connection terminations during legitimate pauses in activity, while setting it too high could result in wasted resources on idle connections.

Config Example

kmp_idle_timeout 5m;

Ensure the timeout value is appropriate for your media application's expected usage patterns to avoid premature disconnection.

Setting the timeout too short may lead to frequent reconnections, negatively affecting performance.

← Back to all directives