live_kmp_dump_folder
The `live_kmp_dump_folder` directive specifies the directory where Kaltura Media Protocol (KMP) live stream dumps are stored.
Description
The live_kmp_dump_folder directive is part of the Kaltura Media Framework Common NGINX Module, facilitating the live streaming of media using Kaltura Media Protocol (KMP). This directive allows users to set a specific folder on the file system for saving live stream dumps, which can be essential for debugging, recovery, or analysis of streams that have been transmitted.
By defining this folder, NGINX can automatically store streams in the specified location whenever a stream is processed. The folder must have the necessary permissions set to allow NGINX to write files to it. Storing live stream dumps can aid in monitoring the stream's quality, analyzing content, and ensuring that no data is lost during transmission.
The directive accepts a single argument: the path to the folder where stream dumps should be saved. Users should ensure this path is valid, accessible, and that sufficient disk space is available to accommodate potentially large data dumps during live events.
Config Example
stream {
live_kmp_dump_folder /var/log/nginx/kmp_dumps;
# Additional stream configuration
}Ensure the folder specified exists and is writable by the NGINX process.
Be mindful of disk space when saving dumps, as they can grow large during lengthy streams.
Incorrect permissions may lead to failed dumps, which could hinder debugging efforts.