live_kmp_log_frames
The 'live_kmp_log_frames' directive enables logging of Kaltura Media Protocol (KMP) frames in NGINX live streaming scenarios.
Description
The 'live_kmp_log_frames' directive is specifically used within the Kaltura Media Framework Common NGINX Module to control the logging behavior of video frames being streamed via Kaltura's Media Protocol (KMP). By enabling this directive, the server can log detailed information about the frames that are processed, which can be crucial for debugging and monitoring streaming performance in real-time applications. This directive can be set in either the stream or stream server context, allowing it to be applied to various levels of configuration depending on the specific requirements of the live streaming setup.
The directive accepts a single argument that specifies whether to enable or disable frame logging. When enabled, the server will produce log entries that capture information about each frame, which can help with performance analysis, troubleshooting playback issues, and optimizing server resource utilization. This logging is particularly useful in a production environment where understanding the flow of data and identifying bottlenecks or errors is essential to maintaining high-quality streaming experiences.
As a performance consideration, it's worth noting that extensive logging can lead to increased I/O operations, potentially impacting overall server performance, especially under heavy load or high traffic. Careful consideration should be given regarding the deployment of this directive in production environments to balance between logging utility and performance impact.
Config Example
stream {
server {
listen 1935;
live_kmp_log_frames on;
... // other directives
}
}Make sure to consider the performance implications of enabling logging, especially under high load.
Ensure that the logging level in NGINX is configured correctly to capture the frames correctly.