persist_bucket_size

The `persist_bucket_size` directive sets the size of the persistence bucket for the Kaltura Media Framework, affecting the management of streaming media resources.

Syntaxpersist_bucket_size size;
Defaultnone
Context
Arguments1

Description

The persist_bucket_size directive is crucial for configuring the Kaltura Media Framework's handling of streamed media, specifically by establishing the size of the persistence bucket allocated for managing stateful media sessions. This directive impacts how media streams are buffered and stored temporarily during processing, directly influencing the performance and resources consumed by the applications leveraging the Kaltura media services. When streams are processed, they may require sufficient storage and operational space to maintain their state, especially for features such as adaptive bitrate streaming and media transcoding.

The parameter for persist_bucket_size determines the maximum capacity for these buckets, and as such, setting an appropriate size is vital for optimal operation. If the bucket size is too small, it may lead to resource contention or data loss, where active streams are interrupted or managed less efficiently. On the other hand, setting the size too large can lead to unnecessary memory consumption, which may not yield performance benefits. Therefore, it's recommended to assess the media traffic and expected load to determine an effective bucket size.

This directive can be defined in the server or location blocks where Kaltura's media services are configured, ensuring that each relevant media processing component operates with the defined persistence parameters. Adjusting this value requires consideration of the total expected number of simultaneous streams and their processing requirements, which can change dramatically based on the deployment scenario.

Config Example

persist_bucket_size 128m;

Ensure that the bucket size does not exceed available memory limits, as this may lead to performance degradation or application crashes.

Adjust the size based on the expected load; a one-size-fits-all approach may lead to underperformance or resource waste.

Monitor the persistence behavior post-configuration to avoid unforeseen issues with stream interruptions.

← Back to all directives