The timeout parameter controls how long Tair (Redis OSS-Compatible) keeps an idle client connection open. When a connection remains idle for the specified duration, Tair closes it and reclaims the resources.
By default, timeout is set to 0, meaning idle connections are never closed. In production, this is risky: if client-side exceptions prevent proper connection cleanup, idle connections accumulate and the connection pool may fill up, which can result in a service failure. Set a timeout value on instances that run core business workloads so that Tair can reclaim connection resources before the pool is exhausted.
How idle connection cleanup works
Tair does not close a connection the instant it reaches the timeout threshold. Background tasks periodically scan for idle connections and close them. The scan frequency is controlled by the hz parameter.
When hz is set to a low value, scans run less often, which creates a delay between when a connection exceeds the timeout and when it is actually closed. For example, with timeout set to 10 seconds, a connection may remain open for up to 12 seconds.
To tighten this gap, increase the hz value so that background tasks run more frequently.
Set the timeout parameter
Make sure that you have a Tair (Redis OSS-Compatible) or Redis Open-Source Edition instance and the permissions to modify instance parameters.
Log on to the console and go to the Instances page. In the top navigation bar, select the region in which the instance that you want to manage resides. Then, find the instance and click the instance ID.
In the left-side navigation pane, click Parameter Settings.
In the parameter list, find the
timeoutparameter and click Modify in the Actions column.In the dialog box that appears, set a new value for
timeout.
Property Detail Valid range 0–100000 Unit Seconds Default 0 (never close idle connections) Takes effect Immediately Click OK.
Verify the result
After you save the change, the new timeout value takes effect immediately. Confirm the update by checking the current value on the Parameter Settings page.
API reference
| API operation | Description |
|---|---|
| DescribeParameters | Query the configuration and operational parameters of an instance |
| ModifyInstanceConfig | Modify the parameter settings of an instance |