persist_max_delta_segments

The `persist_max_delta_segments` directive controls the maximum number of delta segments retained for video streaming in the Kaltura Media Framework.

Syntaxpersist_max_delta_segments number;
Defaultnone
Context
Arguments1

Description

The persist_max_delta_segments directive is part of the Kaltura Media Framework's NGINX module, which is designed to handle live video streaming. This directive allows for the specification of how many delta segments should be stored in memory or disk after they have been generated. Delta segments are incremental video file parts that differ from previously stored segments, and retaining a limited number of these segments optimizes resource usage while enabling graceful degradation of service during component failures or high-load periods.

The parameter for this directive is an integer value that defines the upper limit for delta segments. If set too low, clients may experience gaps or delays in video playback if requested segments are no longer available. Conversely, setting this value too high can lead to excessive resource consumption, especially during peak usage times when many segments are generated rapidly. Careful tuning according to specific deployment scenarios and resource availability is vital for maintaining optimal performance and user experience.

The effective management of delta segments ensures that the media controller can orchestrate video deliveries efficiently, especially in environments where multiple components are interlinked for video transcoding and delivery. This directive plays a crucial role in maintaining the integrity and availability of video streams by dynamically managing segments as they are produced and consumed.

Config Example

persist_max_delta_segments 5;

Setting the value too low may result in missing segments during playback, leading to interruptions.

Overly high values can lead to increased memory and storage usage, potentially degrading server performance.

← Back to all directives