kmp_rtmp_out_write_meta_timeout
Sets the timeout for writing metadata in the Kaltura RTMP output stream.
Description
The kmp_rtmp_out_write_meta_timeout directive defines the amount of time in seconds that NGINX will wait for metadata to be written in the Kaltura RTMP output stream. By adjusting this timeout, administrators can control how long the server should wait before considering a write operation to have failed, which can be especially useful in handling network fluctuations or slow responses from downstream servers. A shorter timeout can help prevent prolonged stalls on the live stream while a longer timeout allows for more robust handling of delays, ultimately impacting the responsiveness and performance of the streaming application.
This directive can be set in both the stream and stream server contexts, making it flexible for various deployment scenarios. It accepts a single numeric argument that specifies the timeout duration in seconds. When no metadata is written within the specified timeout period, NGINX can take appropriate actions based on the module's implementation, which may include logging an error or terminating the connection. Proper configuration of this directive is crucial to maintaining the quality and reliability of live streaming operations, notably for environments where latency and data consistency are paramount.
Config Example
stream {
server {
kmp_rtmp_out_write_meta_timeout 30;
}
}Setting the timeout too low can cause frequent write failures, especially in high-latency networks.
Not all RTMP clients or backends will handle timeout errors gracefully, potentially leading to interrupted streams.