kmp_rtmp_in_log_frames
Enables logging of frame-level data for input streams in the Kaltura Media Framework.
Description
The kmp_rtmp_in_log_frames directive is used within the context of stream and stream server in NGINX configurations that utilize the Kaltura Media Framework Common Module. By enabling this directive, NGINX will log detailed information about the frames being processed in real-time from incoming RTMP streams. This is particularly useful for debugging and monitoring purposes, allowing developers and administrators to analyze the characteristics and behavior of the video frames being transmitted.
The directive accepts a single argument that specifies whether to turn on or off the logging of frame data. When enabled, every frame processed is logged, providing insights into frame rates, sizes, types, and other relevant metrics. This helps in assessing stream quality and diagnosing potential issues in streaming performance. When the logging is turned off, frame data is not recorded, potentially reducing the overhead on the NGINX server and improving performance, but at the cost of losing valuable diagnostic information.
To use this directive effectively, you would include it in the appropriate NGINX configuration block where RTMP input is managed. It is crucial to evaluate the server resources when enabling this feature, as logging a high volume of frame data can lead to increased I/O and possible performance degradation, depending on the server's workload and capabilities.
Config Example
stream {
server {
listen 1935;
kmp_rtmp_in_log_frames on;
}
}Enabling frame logging can cause increased load on the server, which may impact performance.
Make sure the logging output destination is properly configured to avoid log overflow or loss.