ts_kmp_log_frames

The `ts_kmp_log_frames` directive controls the logging of video frames processed through the Kaltura Media Framework in NGINX.

Syntaxts_kmp_log_frames on | off;
Defaultoff
Contextstream, stream server
Arguments1

Description

The ts_kmp_log_frames directive is a configuration parameter that enables or disables the logging of frames as they are processed by the Kaltura Media Framework. This directive is particularly useful for debugging and monitoring the behavior of the media streaming pipeline. When enabled, NGINX will output detailed frame information into the logs, which can help in diagnosing issues related to video streaming or media processing. The logs will contain metrics and potential errors regarding the media frames handled by the server, thus providing insights into the performance and health of a stream.

This directive can take a single argument which can either be 'on' or 'off', indicating whether the logging feature should be activated or deactivated. Proper use of this directive in conjunction with monitoring tools can significantly assist administrators in maintaining optimal media delivery performance. It is important to balance the need for detailed logging with server performance, as excessive logging can lead to increased I/O and reduced processing speed, particularly when dealing with high-throughput video streams.

Config Example

stream {
    server {
        ts_kmp_log_frames on;
        listen 1234;
        proxy_pass backend;
    }
}

Enabling logging may degrade performance if too much output is generated, especially under high load.

The logging output can quickly consume disk space if not managed properly.

← Back to all directives