kmp_ctrl_read_timeout
指令 `kmp_ctrl_read_timeout` 设置 Kaltura Media Framework 在控制连接上等待响应的最大时间。
Kaltura Media Framework Common NGINX Module
语法kmp_ctrl_read_timeout time;
默认值none
上下文
参数1
说明
kmp_ctrl_read_timeout 指令专门用于管理 Kaltura Media Framework 内的读取超时,该框架通常处理通过 Kaltura Media Protocol 通信的多个组件。当建立控制连接时,此指令会有效限制模块等待响应的时长。如果在配置的时间段内未收到任何数据,连接将被关闭,从而防止可能导致资源耗尽或挂起连接的情况,这些情况会影响整体系统性能。
此指令接受一个参数,用于指定超时时间。该值应以秒为单位表示(或时间格式,例如 30s 表示三十秒)。通过恰当配置读取超时,系统管理员可以确保他们的 Kaltura 部署保持最佳响应性,避免因媒体流处理管道中无响应组件而导致的延迟。必须在超时过短(可能不必要地断开连接)与超时过长(在组件未响应时可能导致无反应行为)之间取得平衡。
使用此指令还有助于故障排查和系统性能调优:一旦设定了合理的超时时间,诊断响应时间问题将变得可管理,从而能及时对无响应服务发出警报。对连接关闭进行适当的日志记录有助于分析并改善复杂部署场景中媒体处理路径的健康状况。
配置示例
kmp_ctrl_read_timeout 30s;
⚠
将超时设置得过短可能会导致合法连接被过早关闭,进而导致性能下降。
⚠
注意超时持续时间应与媒体组件的预期响应时间相适应;过长可能会延迟错误检测。