input_bufs_max_free

The 'input_bufs_max_free' directive sets the maximum number of free input buffers that are allowed in the Kaltura Media Framework for NGINX.

Syntaxinput_bufs_max_free number;
Defaultnone
Context
Arguments1

Description

The 'input_bufs_max_free' directive is used to configure the maximum number of free input buffers that NGINX will hold when handling incoming media requests. This directive is particularly relevant in environments where media streaming is optimized, ensuring that the input buffer management does not overwhelm system resources while providing efficiency in data processing.

When clients push media data to the server, NGINX allocates input buffers for incoming requests. By limiting the maximum number of free buffers, this directive helps in managing memory allocation efficiently. It effectively controls how many buffers remain unused in memory, and if the count exceeds the specified limit, NGINX may start releasing those buffers. This feature becomes crucial under high load, ensuring that we do not consume memory indiscriminately which could lead to performance degradation or resource exhaustion.

The configured value must be a positive integer, and setting it appropriately depends on the expected media load and server capabilities. It is advisable to monitor server performance and adjust this setting based on empirical data to achieve the best balance between performance and resource utilization.

Config Example

input_bufs_max_free 10;

Setting the value too low might lead to performance issues under heavy load as buffers will be released too frequently.

Conversely, setting this value too high could lead to excessive memory consumption, impacting overall server performance.

← Back to all directives