kmp_log_frames

The `kmp_log_frames` directive configures the logging of Kaltura Media Protocol (KMP) frames within the NGINX server.

Syntaxkmp_log_frames on | off;
Defaultoff
Context
Arguments1

Description

The kmp_log_frames directive is an internal setting used in the Kaltura Media Framework module for NGINX, which enables or disables the logging of frames for media streams transmitted using the Kaltura Media Protocol (KMP). This directive takes a single argument which can either be 'on' or 'off', determining whether the frames will be recorded in the server logs. When enabled, detailed logs of the frames that are being processed will be generated, which can be critical for debugging and monitoring live video streaming sessions.

When logging is enabled, the directive records important metrics related to media frames sent over KMP, which could include the number of frames processed, timestamps, and potentially the frame content if configured. This can provide valuable insights into the performance and operation of the media streaming application, making it easier for developers and system administrators to troubleshoot any issues that may arise during media delivery. However, extensive logging can also lead to increased I/O operations, which could affect server performance, especially under high traffic conditions. Therefore, it is important to consider the implications before enabling this directive in a production environment.

Config Example

kmp_log_frames on;

Enabling logging may lead to increased disk I/O and could affect performance under heavy load.

Logs generated can quickly grow in size, so it's essential to manage log rotation and archiving.

← Back to all directives