kmp_max_free_buffers

The `kmp_max_free_buffers` directive configures the maximum number of free buffers allocated for Kaltura Media Framework processing in NGINX.

Syntaxkmp_max_free_buffers number;
Defaultnone
Context
Arguments1

Description

The kmp_max_free_buffers directive specifically addresses the buffer management within the Kaltura Media Framework, which is essential for handling media streaming efficiently. This directive sets the upper limit on the number of free buffers that the system can maintain at any given time. When processing media requests, buffers are used to temporarily hold data in memory before it is sent to clients. By tuning this parameter, server administrators can optimize memory usage based on expected load and streaming characteristics.

Exceeding the specified buffer limit can potentially lead to degraded performance or failures in processing media streams due to exhaustion of available resources. Conversely, setting the limit too low may result in unnecessary memory churn as buffers are frequently allocated and de-allocated, also impacting throughput. Thus, it is crucial to evaluate the average media request sizes and the server’s overall capacity to determine an optimal value for kmp_max_free_buffers. The directive accepts a single integer argument, which represents the maximum number of free buffers permissible.

Overall, using the kmp_max_free_buffers directive appropriately helps achieve a fine balance between memory efficiency and performance, allowing the Kaltura Media Framework to scale effectively as media streaming demands fluctuate across workloads.

Config Example

kmp_max_free_buffers 1000;

Setting the value too low may lead to frequent allocation and deallocation of buffers, increasing memory pressure.

If set too high, it might exhaust available memory and cause application failures.

Changes to this directive require careful monitoring after application to ensure system stability.

← Back to all directives