kmp_rtmp_out_dump_folder
The `kmp_rtmp_out_dump_folder` directive sets the directory where RTMP output files will be dumped during streaming operations.
Description
The kmp_rtmp_out_dump_folder directive is utilized within the context of the Kaltura Media Framework, specifically for RTMP output operations. When specified, it defines the folder path where all outgoing RTMP streams will be recorded as dump files. This feature is essential for debugging, monitoring, or archiving live streams, allowing users to later review or analyze the streaming data.
The directive accepts a single argument, which should be the absolute path to the desired dump folder. The module will attempt to write the dump files into this specified directory during streaming. If the directory does not exist or cannot be accessed due to permission issues, NGINX will log an error and may silently ignore the dump request depending on the error handling configuration. This ensures that users can have a level of control over where their stream data is stored, possibly directing it to a specific storage solution or ensuring it resides on a fast-access local disk.
Employing this directive is straightforward—simply include it in your nginx.conf within the appropriate context (either stream or stream server). It is important for users to create and manage the folder path beforehand, ensuring that the NGINX user has the necessary permissions to write to the target directory, as failure to do so can lead to issues with stream dumping.
Config Example
stream {
server {
listen 1935;
kmp_rtmp_out_dump_folder /var/log/nginx/rtmp_dumps;
}
}Ensure the specified dump folder exists; NGINX won't create it for you.
Check directory permissions to avoid write errors during streaming.
Path must be absolute; relative paths are not supported.