ll_segmenter_dispose_threshold

The `ll_segmenter_dispose_threshold` directive defines the maximum number of segments to retain in memory before the segmenter disposes of the oldest ones.

Syntaxll_segmenter_dispose_threshold number;
Defaultnone
Context
Arguments1

Description

The ll_segmenter_dispose_threshold directive is part of the Kaltura Media Framework Common NGINX Module, which is intended for managing streaming media, particularly in conjunction with segmented streaming protocols like DASH. This directive specifies a threshold for managing memory usage by limiting the number of media segments that can be stored in memory at any given time. When the number of stored segments exceeds this threshold, the segmenter will begin to dispose of the oldest segments to free up memory resources.

The parameter for this directive is a single integer value that indicates the maximum number of segments to keep in memory. Setting this threshold effectively balances memory usage with the ability to quickly access segments for streaming. If set too low, there may be performance issues as segments are repeatedly disposed of and re-fetched, while a value that is too high could lead to excessive memory consumption, potentially affecting the overall performance of the NGINX server hosting the media services.

This directive is especially critical in high-load scenarios where numerous streaming sessions might be active simultaneously, facilitating more efficient resource management and maintaining optimal streaming performance. Proper configuration requires monitoring segment access patterns and adjusting the threshold based on operational needs and memory constraints.

Config Example

ll_segmenter_dispose_threshold 100;

Setting the threshold too high can lead to excessive memory usage, causing performance degradation.

If set too low, streams may encounter latency due to frequent fetching and disposal of segments.

← Back to all directives