ts_kmp_ctrl_buffer_size

Sets the size of the control buffer for the Kaltura Media Protocol (KMP) in NGINX.

Syntaxts_kmp_ctrl_buffer_size size;
Defaultnone
Contextstream, stream server
Arguments1

Description

The ts_kmp_ctrl_buffer_size directive configures the size of the control buffer used for managing Kaltura Media Protocol (KMP) interactions. This buffer is critical in handling JSON events sent between media processing components and the Kaltura controller. By adjusting this parameter, administrators can optimize the performance of the media pipeline, especially under varying workloads. A larger buffer might be beneficial for environments with higher event throughput, while a smaller buffer might suffice in low-traffic scenarios. The directive accepts a value expressed in bytes, allowing for fine-grained control over the buffer size.

When NGINX initializes the KMP, the specified buffer size is allocated. If the demands of the media processing require more space than allocated, it may lead to dropped events or performance degradation. Conversely, unnecessarily large buffers can waste memory resources, particularly in scenarios where traffic is low or predictable. Monitoring the application and adjusting this directive based on actual usage patterns is recommended to ensure an optimal configuration for media streaming operations.

Config Example

ts_kmp_ctrl_buffer_size 64k;

Setting the buffer size too small may result in dropped JSON events or errors in data handling.

Oversized buffers can waste memory resources and impact performance if not required for the workload.

← Back to all directives