kmp_ctrl_retries

The kmp_ctrl_retries directive is part of the Kaltura Media Framework Common NGINX Module, which is used for managing distributed media components in a streaming architecture. When the KMP controller sends HTTP requests to media components, it may encounter failures due to various issues such as network instability or component unavailability. The kmp_ctrl_retries directive allows users to specify how many times the controller should attempt to retry the request before considering the operation as failed.

The parameter for this directive is a positive integer indicating the number of retry attempts. If set to 3, for example, the controller will try to re-attempt the request three times in case of failure. This can help in scenarios where transient failures occur and retries may succeed. However, it is essential to be cautious with this directive since excessive retries can lead to increased latency and resource utilization, thus negatively impacting the system's performance during error scenarios.

Configuration of this directive should be done based on the reliability of the underlying media components and network infrastructure. It’s advisable to perform testing to find an optimal number of retries that balances resilience and performance.