kmp_rtmp_out_dump_folder
`kmp_rtmp_out_dump_folder` 指令设置在流媒体传输过程中 RTMP 输出文件将被转储的目录。
Kaltura Media Framework Common NGINX Module
·
streamstream server
语法kmp_rtmp_out_dump_folder path;
默认值none
上下文stream, stream server
参数1
说明
kmp_rtmp_out_dump_folder 指令在 Kaltura Media Framework 的上下文中使用，专门用于 RTMP 输出操作。指定时，它定义了所有外发 RTMP 流将被记录为转储文件的文件夹路径。该功能对于调试、监控或归档直播流至关重要，允许用户在事后查看或分析流媒体数据。
该指令接受单个参数，参数应为目标转储文件夹的绝对路径。模块将在流媒体传输期间尝试将转储文件写入此指定目录。如果目录不存在或由于权限问题无法访问，NGINX 将记录错误，并且根据错误处理配置可能会静默忽略转储请求。这样可以确保用户对流数据的存放位置有一定的控制，例如将其指向特定的存储方案，或确保其位于高速本地磁盘上。
使用此指令很简单 - 只需在适当的上下文中（例如在 nginx.conf 中的 stream 或 stream server）包含它即可。用户需要事先创建并管理该文件夹路径，确保 NGINX 用户具有向目标目录写入的必要权限，否则可能导致流转储失败或相关问题。
配置示例
stream {
server {
listen 1935;
kmp_rtmp_out_dump_folder /var/log/nginx/rtmp_dumps;
}
}⚠
确保指定的转储文件夹已存在；NGINX 不会为你创建它。
⚠
检查目录权限以避免在流式传输期间发生写入错误。
⚠
路径必须为绝对路径；不支持相对路径。