store_http_read_retry_interval

The `store_http_read_retry_interval` directive sets the time interval for retrying failed read requests in the Kaltura Media Framework.

Syntaxstore_http_read_retry_interval time;
Defaultnone
Context
Arguments1

Description

The store_http_read_retry_interval directive is used in the context of managing read operations directed at HTTP storage backends in the Kaltura Media Framework. Its primary function is to define how long NGINX should wait before attempting to retry a read request after a failure has been detected. This is particularly useful in scenarios where temporary issues like network glitches or backend unavailability may cause read operations to fail, enabling seamless handling of transient errors without impacting overall service availability.

When this directive is set, NGINX will not immediately retry a failed read request but will instead wait for the defined interval before making another attempt. The interval is specified in seconds, providing flexibility in managing how quickly NGINX should re-engage with the storage system after an error has occurred. Such a configuration can be crucial for optimizing resource utilization and network traffic, as aggressive retry mechanisms can lead to increased loads on backends during temporary outages instead of backing off and allowing for recovery.

As a best practice, setting an appropriate value for this directive is crucial, as too short an interval may lead to unnecessary load on backends, while too long an interval can result in higher latency in processing requests. Operators should tune this parameter based on the characteristics of their backend services and the likelihood of transient failure situations.

Config Example

store_http_read_retry_interval 5s;

Ensure that the value set does not lead to excessive delays in request processing.

Consider the nature of the backend services; some might require longer timeouts than others.

← Back to all directives