dump_folder
`dump_folder` 指令指定用于存放 Kaltura Media Framework 的调试信息或输出文件的目录。
Kaltura Media Framework Common NGINX Module
语法dump_folder path;
默认值none
上下文
参数1
说明
Kaltura Media Framework Common NGINX Module 中的 dump_folder 指令允许用户定义一个目录路径，将在媒体处理任务执行期间生成的所有调试转储和日志写入该目录。该目录作为临时文件的集中位置，可帮助调试和排查与媒体处理相关的问题。
配置该指令后，框架会在指定文件夹中自动创建文件，捕获处理管道各个阶段的状态或输出。这些文件可以包括原始媒体数据、JSON 格式的日志或临时的调试信息，供开发者用于对媒体处理堆栈进行深入分析。必须在配置中指定 dump_folder 的路径，并为 NGINX 用户设置适当的写权限，以避免运行时出现权限错误。
要有效使用此指令，需要关注存储需求，因为该文件夹中保留的数据可能会根据处理媒体的数量和复杂性而意外增长。因此，通常建议监控该目录并实施清理策略或限制保留时间/大小，以避免占用过多磁盘空间。
配置示例
dump_folder /var/log/nginx/kaltura_dumps;
⚠
确保所指定的目录具有适当的权限，以便 NGINX 进程能够写入文件。
⚠
监控转储文件夹的磁盘空间，以避免因过多的日志记录而耗尽存储。
⚠
参数 path 必须是有效的路径；否则 NGINX 可能无法启动或重新加载。