Files
doc-exports/docs/dcs/umn/dcs-ug-0312024.html
Chen, Junjie 748ac2c008 DCS UMN 20230811 version
Reviewed-by: Mützel, Andrea <andrea.muetzel@t-systems.com>
Co-authored-by: Chen, Junjie <chenjunjie@huawei.com>
Co-committed-by: Chen, Junjie <chenjunjie@huawei.com>
2024-01-24 14:13:13 +00:00

301 lines
38 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<a name="dcs-ug-0312024"></a><a name="dcs-ug-0312024"></a>
<h1 class="topictitle1">Modifying Configuration Parameters</h1>
<div id="body8662426"><p id="dcs-ug-0312024__p1585685392217">You can modify the configuration parameters of your DCS instance to optimize DCS performance based on your requirements.</p>
<p id="dcs-ug-0312024__p16781134718348">For example, if you do not need data persistence, set <strong id="dcs-ug-0312024__b73785499545">appendonly</strong> to <strong id="dcs-ug-0312024__b14892575548">no</strong>.</p>
<div class="note" id="dcs-ug-0312024__note378833114173"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dcs-ug-0312024__p1278943131720">After the instance configuration parameters are modified, the modification takes effect immediately without the need to manually restart the instance. For a cluster instance, the modification takes effect on all shards.</p>
</div></div>
<div class="section" id="dcs-ug-0312024__en-us_topic_0148195239_section4626406517526"><a name="dcs-ug-0312024__en-us_topic_0148195239_section4626406517526"></a><a name="en-us_topic_0148195239_section4626406517526"></a><h4 class="sectiontitle">Procedure</h4><ol id="dcs-ug-0312024__en-us_topic_0148195239_ol363518281765"><li id="dcs-ug-0312024__li1799392835619"><span>Log in to the DCS console.</span></li><li id="dcs-ug-0312024__li19668467518"><span>Click <span><img id="dcs-ug-0312024__image12972435513" src="en-us_image_0000001194523045.png"></span> in the upper left corner and select a region and a project.</span></li><li id="dcs-ug-0312024__li18411387341"><span>In the navigation pane, choose <strong id="dcs-ug-0312024__b9649842105720">Cache Manager</strong>.</span></li><li id="dcs-ug-0312024__en-us_topic_0148195239_li26520051765"><span>On the <strong id="dcs-ug-0312024__en-us_topic_0148195239_b2598608">Cache Manager</strong> page, click the name of the DCS instance you want to configure.</span></li><li id="dcs-ug-0312024__en-us_topic_0148195239_li6318234617851"><span>Choose <strong id="dcs-ug-0312024__b14822173412555">Instance Configuration</strong> &gt; <strong id="dcs-ug-0312024__b082343485519">Parameters</strong>.</span></li><li id="dcs-ug-0312024__en-us_topic_0148195239_li800987517934"><span>On the <strong id="dcs-ug-0312024__en-us_topic_0148195239_b133114206435">Parameters</strong> page, click <strong id="dcs-ug-0312024__en-us_topic_0148195239_b331118206434">Modify</strong>.</span></li><li id="dcs-ug-0312024__en-us_topic_0148195239_li41707026171054"><span>Modify parameters based on your requirements.</span><p><p id="dcs-ug-0312024__p7413163824319"><a href="#dcs-ug-0312024__en-us_topic_0148195239_table14227144219555">Table 1</a> describes the parameters. In most cases, retain the default values.</p>
<div class="tablenoborder"><a name="dcs-ug-0312024__en-us_topic_0148195239_table14227144219555"></a><a name="en-us_topic_0148195239_table14227144219555"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-ug-0312024__en-us_topic_0148195239_table14227144219555" frame="border" border="1" rules="all"><caption><b>Table 1 </b>DCS Redis instance configuration parameters</caption><thead align="left"><tr id="dcs-ug-0312024__en-us_topic_0148195239_row1322744216550"><th align="left" class="cellrowborder" valign="top" width="19.86%" id="mcps1.3.4.2.7.2.2.2.5.1.1"><p id="dcs-ug-0312024__en-us_topic_0148195239_p122717424559"><strong id="dcs-ug-0312024__en-us_topic_0148195239_b82291641446">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.15%" id="mcps1.3.4.2.7.2.2.2.5.1.2"><p id="dcs-ug-0312024__en-us_topic_0148195239_p22271842155519"><strong id="dcs-ug-0312024__en-us_topic_0148195239_b1871010193497">Description</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="32.53%" id="mcps1.3.4.2.7.2.2.2.5.1.3"><p id="dcs-ug-0312024__en-us_topic_0148195239_p22271042145516"><strong id="dcs-ug-0312024__en-us_topic_0148195239_b101621277497">Value Range</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.46%" id="mcps1.3.4.2.7.2.2.2.5.1.4"><p id="dcs-ug-0312024__en-us_topic_0148195239_p1222784211552"><strong id="dcs-ug-0312024__en-us_topic_0148195239_b117451132114911">Default Value</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dcs-ug-0312024__row627210513121"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__p1325414263492">active-expire-num</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p429742444914">Number of expired keys that can be deleted in regular scans.</p>
<p id="dcs-ug-0312024__p2660467343">Redis 3.0 instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__p1297152418496">11000</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__p122972241496">20</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row122734218551"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p10227114214554">timeout</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p2227174265517">The maximum amount of time (in seconds) a connection between a client and the DCS instance can be allowed to remain idle before the connection is terminated. A setting of <strong id="dcs-ug-0312024__b3419341204717">0</strong> means that this function is disabled.</p>
<p id="dcs-ug-0312024__p76461186189">Proxy Cluster instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p522724255510">07200 seconds</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p32271942165514">0</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row79061955513"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p390019175516">appendfsync</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p2675361014">Controls how often fsync() transfers cached data to the disk. Note that some OSs will perform a complete data transfer but some others only make a "best-effort" attempt.</p>
<p id="dcs-ug-0312024__en-us_topic_0148195239_p196751764015">There are three settings:</p>
<p id="dcs-ug-0312024__en-us_topic_0148195239_p176758619015">no: fsync() is never called. The OS will flush data when it is ready. This mode offers the highest performance.</p>
<p id="dcs-ug-0312024__en-us_topic_0148195239_p26751961803">always: fsync() is called after every write to the AOF. This mode is very slow, but also very safe.</p>
<p id="dcs-ug-0312024__en-us_topic_0148195239_p106751767016">everysec: fsync() is called once per second. This mode provides a compromise between safety and performance.</p>
<p id="dcs-ug-0312024__p9954205519148">Single-node instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><ul id="dcs-ug-0312024__en-us_topic_0148195239_ul188812513339"><li id="dcs-ug-0312024__en-us_topic_0148195239_li98817511331">no</li><li id="dcs-ug-0312024__en-us_topic_0148195239_li68810503318">always</li><li id="dcs-ug-0312024__en-us_topic_0148195239_li5881523318">everysec</li></ul>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__p191611291628">no</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row39141919554"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p391181935516">appendonly</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p96521028910">Indicates whether to log each modification of the instance. By default, data is written to disks asynchronously in Redis. If this function is disabled, recently-generated data might be lost in the event of a power failure. Options:</p>
<p id="dcs-ug-0312024__en-us_topic_0148195239_p965216287116">yes: enabled</p>
<p id="dcs-ug-0312024__en-us_topic_0148195239_p17652192817114">no: disabled</p>
<p id="dcs-ug-0312024__p6806152815107">Single-node instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><ul id="dcs-ug-0312024__en-us_topic_0148195239_ul1431235812335"><li id="dcs-ug-0312024__en-us_topic_0148195239_li631215582331">yes</li><li id="dcs-ug-0312024__en-us_topic_0148195239_li1917111123417">no</li></ul>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1391819115513">yes</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row14911819125519"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p39101914552">client-output-buffer-limit-slave-soft-seconds</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p5789926131111">Number of seconds that the output buffer remains above <strong id="dcs-ug-0312024__b06523418144">client-output-buffer-slave-soft-limit</strong> before the client is disconnected.</p>
<p id="dcs-ug-0312024__p17803121314161">Single-node instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p189131915520">060</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1091151945518">60</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row1691111916552"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p6911319195519">client-output-buffer-slave-hard-limit</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p195096271017">Hard limit (in bytes) on the output buffer of replica clients. Once the output buffer exceeds the hard limit, the client is immediately disconnected.</p>
<p id="dcs-ug-0312024__p18819192118162">Single-node instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p99141914558">Depends on the instance type and specifications.</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__p8776143161316">Depends on the instance type and specifications.</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row6911619165515"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p10911119165517">client-output-buffer-slave-soft-limit</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p89161920555">Soft limit (in bytes) on the output buffer of replica clients. Once the output buffer exceeds the soft limit and continuously remains above the limit for the time specified by the <strong id="dcs-ug-0312024__b9968103710156">client-output-buffer-limit-slave-soft-seconds</strong> parameter, the client is disconnected.</p>
<p id="dcs-ug-0312024__p19408182519169">Single-node instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__p166285719133">Depends on the instance type and specifications.</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__p879118561411">Depends on the instance type and specifications.</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row18227174214552"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p22272428553">maxmemory-policy</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p4905157161519">The deletion policy to apply when the maxmemory limit is reached. Options:</p>
<p id="dcs-ug-0312024__p1522012016169"><strong id="dcs-ug-0312024__b9540642716116">volatile-lru</strong>: Evict keys by trying to remove the less recently used (LRU) keys first, but only among keys that have an expire set. <strong id="dcs-ug-0312024__b3934999216116">(Recommended)</strong></p>
<p id="dcs-ug-0312024__p36837271614"><strong id="dcs-ug-0312024__b11074576846116">allkeys-lru</strong>: Evict keys by trying to remove the LRU keys first.</p>
<p id="dcs-ug-0312024__p13470692160"><strong id="dcs-ug-0312024__b5679002646116">volatile-random</strong>: evict keys randomly, but only evict keys with an expire set.</p>
<p id="dcs-ug-0312024__p142038128164"><strong id="dcs-ug-0312024__b5881962086116">allkeys-random</strong>: Evict keys randomly.</p>
<p id="dcs-ug-0312024__p731421161210"><strong id="dcs-ug-0312024__b11833152276116">volatile-ttl</strong>: Evict keys with an expire set, and try to evict keys with a shorter time to live (TTL) first.</p>
<p id="dcs-ug-0312024__p14981928151618"><strong id="dcs-ug-0312024__b6903831446116">noeviction</strong>: Do not delete any keys and only return errors when the memory limit was reached.</p>
<p id="dcs-ug-0312024__p1126291851619"><strong id="dcs-ug-0312024__b9754895416116">volatile-lfu</strong>: Evict keys by trying to remove the less frequently used (LFU) keys first, but only among keys that have an expire set.</p>
<p id="dcs-ug-0312024__p111224390156"><strong id="dcs-ug-0312024__b4585670666116">allkeys-lfu</strong>: Evict keys by trying to remove the LFU keys first.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__p49981718131719">Depends on the instance version.</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__p586974591719">Depends on the instance version and type.</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row107521734145718"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p6752193405719">lua-time-limit</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1975213344578">Maximum time allowed for executing a Lua script (in milliseconds).</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1275253412579">1005000</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p10752163435712">5,000</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row975283411578"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p15752103495711">master-read-only</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p10752234185715">Sets the instance to be read-only. All write operations will fail.</p>
<p id="dcs-ug-0312024__p4766415172119">Proxy Cluster instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><ul id="dcs-ug-0312024__en-us_topic_0148195239_ul52411934395"><li id="dcs-ug-0312024__en-us_topic_0148195239_li11241143163913">yes</li><li id="dcs-ug-0312024__en-us_topic_0148195239_li10241739398">no</li></ul>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p4753113415577">no</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row16753234105717"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p4753173435713">maxclients</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1075333413572">The maximum number of clients allowed to be concurrently connected to a DCS instance.</p>
<p id="dcs-ug-0312024__p12150622112113">Proxy Cluster instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__p1694810362710">Depends on the instance type and specifications.</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p3753634175714">Depends on the instance type and specifications.</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row17753634185718"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p15753143485715">proto-max-bulk-len</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p875317341573">Maximum size of a single element request (in bytes).</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p775383495717">1,048,576536,870,912</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p13753163435715">536,870,912</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row57531734175711"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p0753113417574">repl-backlog-size</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p2753134135716">The replication backlog size (bytes). The backlog is a buffer that accumulates replica data when replicas are disconnected from the master. When a replica reconnects, a partial synchronization is performed to synchronize the data that was missed while replicas were disconnected.</p>
<p id="dcs-ug-0312024__p489917286174">Single-node instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p0753193455714">16,3841,073,741,824</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1753434175713">1,048,576</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row1753103416571"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p175473495711">repl-backlog-ttl</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p157541534145717">The amount of time, in seconds, before the backlog buffer is released, starting from the last a replica was disconnected. The value <strong id="dcs-ug-0312024__en-us_topic_0148195239_b5247181895510">0</strong> indicates that the backlog is never released.</p>
<p id="dcs-ug-0312024__p165819321170">Single-node instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p87541034125714">0604,800</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1575433425712">3,600</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row19754103495719"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p875483485719">repl-timeout</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p177548344574">Replication timeout (in seconds).</p>
<p id="dcs-ug-0312024__p14659143916174">Single-node instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p7754334155712">303,600</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1175483418573">60</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row0227242155520"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p32271042135515">hash-max-ziplist-entries</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p5847192133215">Hashes are encoded using a memory efficient data structure when the number of entries in hashes is less than the value of this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p10227144216551">110,000</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p18227124219550">512</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row822713422555"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p62271542145517">hash-max-ziplist-value</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p534820123119">Hashes are encoded using a memory efficient data structure when the biggest entry in hashes does not exceed the length threshold indicated by this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p19227442195517">110,000</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1522774215556">64</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row15227144217558"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p16227124265516">set-max-intset-entries</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p17631529103211">When a set is composed of just strings that happen to be integers in radix 10 in the range of 64 bit signed integers, sets are encoded using a memory efficient data structure.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p102271842145515">110,000</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1227164285513">512</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row937819271308"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p6379122712014">zset-max-ziplist-entries</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p1767035063215">Sorted sets are encoded using a memory efficient data structure when the number of entries in sorted sets is less than the value of this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p5380182712018">110,000</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p123805271307">128</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row11863311007"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1086731105">zset-max-ziplist-value</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p127012193318">Sorted sets are encoded using a memory efficient data structure when the biggest entry in sorted sets does not exceed the length threshold indicated by this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p18861931406">110,000</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1386173110011">64</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row8662182083212"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p366482013212">latency-monitor-threshold</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p144643310348">Threshold time in latency monitoring. Unit: millisecond.</p>
<p id="dcs-ug-0312024__p294293773415">Set to <strong id="dcs-ug-0312024__b187864716554">0</strong>: Latency monitoring is disabled.</p>
<p id="dcs-ug-0312024__p15903358203412">Set to more than 0: All with at least this many milliseconds of latency will be logged.</p>
<p id="dcs-ug-0312024__p1189971143411">By running the <strong id="dcs-ug-0312024__b16761648155111">LATENCY</strong> command, you can perform operations related to latency monitoring, such as obtaining statistical data, and configuring and enabling latency monitoring.</p>
<p id="dcs-ug-0312024__p1913404793313">Proxy Cluster instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p86643202320">086,400,000 ms</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p86645205321">0</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row10876104504711"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p11878645204713">notify-keyspace-events</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p5364171633615">Controls which keyspace events notifications are enabled for. If the value is an empty string, this function is disabled. A combination of different values can be used to enable notifications for multiple event types. Possible values:</p>
<p id="dcs-ug-0312024__p5179181811363"><strong id="dcs-ug-0312024__b15677514452">K</strong>: Keyspace events, published with the <strong id="dcs-ug-0312024__b899853936116">__keyspace@__</strong> prefix.</p>
<p id="dcs-ug-0312024__p1428612514367"><strong id="dcs-ug-0312024__b1662907104514">E</strong>: Keyevent events, published with __keyevent@__ prefix</p>
<p id="dcs-ug-0312024__p5551744173613"><strong id="dcs-ug-0312024__b8250410184519">g</strong>: Generic commands (non-type specific) such as DEL, EXPIRE, and RENAME</p>
<p id="dcs-ug-0312024__p894202816361"><strong id="dcs-ug-0312024__b18243141234515">$</strong>: String commands</p>
<p id="dcs-ug-0312024__p450353018363"><strong id="dcs-ug-0312024__b1336651404519">l</strong>: List commands</p>
<p id="dcs-ug-0312024__p8248032183612"><strong id="dcs-ug-0312024__b1462841724515">s</strong>: Set commands</p>
<p id="dcs-ug-0312024__p1428847183613"><strong id="dcs-ug-0312024__b18773019124513">h</strong>: Hash commands</p>
<p id="dcs-ug-0312024__p570795433612"><strong id="dcs-ug-0312024__b1466613213459">z</strong>: Sorted set commands</p>
<p id="dcs-ug-0312024__p17186804377"><strong id="dcs-ug-0312024__b958732314458">x</strong>: Expired events (events generated every time a key expires)</p>
<p id="dcs-ug-0312024__p933714393717"><strong id="dcs-ug-0312024__b19204122524516">e</strong>: Evicted events (events generated when a key is evicted for maxmemory)</p>
<p id="dcs-ug-0312024__p19656193014376"><strong id="dcs-ug-0312024__b331152714510">A</strong>: an alias for "g$lshzxe"</p>
<p id="dcs-ug-0312024__p17526105843519">The parameter value must contain either <strong id="dcs-ug-0312024__b165641519134618">K</strong> or <strong id="dcs-ug-0312024__b13299161716463">E</strong>. <strong id="dcs-ug-0312024__b1233902512469">A</strong> cannot be used together with any of the characters in "g$lshzxe". For example, the value <strong id="dcs-ug-0312024__b582317457461">Kl</strong> means that Redis will notify Pub/Sub clients about keyspace events and list commands. The value <strong id="dcs-ug-0312024__b1972765634613">AKE</strong> means Redis will notify Pub/Sub clients about all events.</p>
<p id="dcs-ug-0312024__p19796310122219">Proxy Cluster instances do not have this parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__p115501448103711">See the parameter description.</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p18452173419149">Ex</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row1947185874012"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1047213586401">slowlog-log-slower-than</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p18972244203815">Redis records queries that exceed a specified execution time.</p>
<p id="dcs-ug-0312024__p10291182873812"><strong id="dcs-ug-0312024__b3630259154320">slowlog-log-slower-than</strong> is the maximum time allowed, in microseconds, for command execution. If this threshold is exceeded, Redis will record the query.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p5472135824014">01,000,000</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p6472165834017">10,000</p>
</td>
</tr>
<tr id="dcs-ug-0312024__en-us_topic_0148195239_row515073174119"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.7.2.2.2.5.1.1 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p14151638418">slowlog-max-len</p>
</td>
<td class="cellrowborder" valign="top" width="33.15%" headers="mcps1.3.4.2.7.2.2.2.5.1.2 "><p id="dcs-ug-0312024__p11344203391">The maximum allowed number of slow queries that can be logged. Slow query log consumes memory, but you can reclaim this memory by running the <strong id="dcs-ug-0312024__b11745622124519">SLOWLOG RESET</strong> command.</p>
</td>
<td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.4.2.7.2.2.2.5.1.3 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p1715123104114">01000</p>
</td>
<td class="cellrowborder" valign="top" width="14.46%" headers="mcps1.3.4.2.7.2.2.2.5.1.4 "><p id="dcs-ug-0312024__en-us_topic_0148195239_p01511937413">128</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="note" id="dcs-ug-0312024__en-us_topic_0148195239_note144501934141719"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ol type="a" id="dcs-ug-0312024__en-us_topic_0148195239_ol646752091117"><li id="dcs-ug-0312024__en-us_topic_0148195239_li9468162010119">For more information about the parameters described in <a href="#dcs-ug-0312024__en-us_topic_0148195239_table14227144219555">Table 1</a>, visit <a href="https://redis.io/topics/memory-optimization" target="_blank" rel="noopener noreferrer">https://redis.io/topics/memory-optimization</a>.</li><li id="dcs-ug-0312024__en-us_topic_0148195239_li195212421117">The <strong id="dcs-ug-0312024__en-us_topic_0148195239_b5115421719">latency-monitor-threshold</strong> parameter is usually used for fault location. After locating faults based on the latency information collected, change the value of <strong id="dcs-ug-0312024__en-us_topic_0148195239_b1861114720713">latency-monitor-threshold</strong> to <strong id="dcs-ug-0312024__en-us_topic_0148195239_b176111271672">0</strong> to avoid unnecessary latency.</li><li id="dcs-ug-0312024__en-us_topic_0148195239_li1690693221116">More about the <strong id="dcs-ug-0312024__en-us_topic_0148195239_b5807192893413">notify-keyspace-events</strong> parameter:<ul id="dcs-ug-0312024__en-us_topic_0148195239_ul717020550153"><li id="dcs-ug-0312024__en-us_topic_0148195239_li1017065512158">The parameter setting must contain at least a <strong id="dcs-ug-0312024__en-us_topic_0148195239_b4285122612510">K</strong> or <strong id="dcs-ug-0312024__en-us_topic_0148195239_b391142402519">E</strong>.</li><li id="dcs-ug-0312024__en-us_topic_0148195239_li13284141041712"><strong id="dcs-ug-0312024__en-us_topic_0148195239_b3324111320492">A</strong> is an alias for "g$lshzxe" and cannot be used together with any of the characters in "g$lshzxe".</li><li id="dcs-ug-0312024__en-us_topic_0148195239_li12704153313198">For example, the value <strong id="dcs-ug-0312024__en-us_topic_0148195239_b13309145919494">Kl</strong> means that Redis will notify Pub/Sub clients about keyspace events and list commands. The value <strong id="dcs-ug-0312024__en-us_topic_0148195239_b156014325011">AKE</strong> means Redis will notify Pub/Sub clients about all events.</li></ul>
</li><li id="dcs-ug-0312024__li11200155211455">Configurable parameters and their values vary depending on the instance type.</li></ol>
</div></div>
</p></li><li id="dcs-ug-0312024__en-us_topic_0148195239_li12191110533"><span>After you have finished setting the parameters, click <strong id="dcs-ug-0312024__en-us_topic_0148195239_b992438816356">Save</strong>.</span></li><li id="dcs-ug-0312024__en-us_topic_0148195239_li345743917110"><span>Click <strong id="dcs-ug-0312024__en-us_topic_0148195239_b44236011163516">Yes</strong> to confirm the modification.</span></li></ol>
</div>
<div class="section" id="dcs-ug-0312024__section8308129127"><h4 class="sectiontitle">Typical Scenarios of Configuring Parameters</h4><p id="dcs-ug-0312024__p2487437111217">The following describes how to change the value of the <strong id="dcs-ug-0312024__b0188165615259">appendonly</strong> parameter:</p>
<ul id="dcs-ug-0312024__ul11935718181319"><li id="dcs-ug-0312024__li7935121831319">If Redis is used as the cache and services are insensitive to Redis data losses, disable instance persistence to improve performance. In this case, change the value of <strong id="dcs-ug-0312024__b89101828182714">appendonly</strong> to <strong id="dcs-ug-0312024__b04322301274">no</strong>. For details, see <a href="#dcs-ug-0312024__en-us_topic_0148195239_section4626406517526">Procedure</a>.</li><li id="dcs-ug-0312024__li278919216136">If Redis is used as the database or services are sensitive to Redis data losses, enable instance persistence. In this case, change the value of <strong id="dcs-ug-0312024__b10928113742712">appendonly</strong> to <strong id="dcs-ug-0312024__b1492823782711">yes</strong>. For details, see <a href="#dcs-ug-0312024__en-us_topic_0148195239_section4626406517526">Procedure</a>. After instance persistence is enabled, you need to consider the frequency of writing Redis cache data to disks and the impact on the Redis performance. You can use this parameter together with the <strong id="dcs-ug-0312024__b18286142819291">appendfsync</strong> parameter. There are three modes of calling fsync():<ul id="dcs-ug-0312024__ul1694044081314"><li id="dcs-ug-0312024__li4275173418139"><strong id="dcs-ug-0312024__b583218102307">no</strong>: fsync() is never called. The OS will flush data when it is ready. This mode offers the highest performance.</li><li id="dcs-ug-0312024__li7213444141312"><strong id="dcs-ug-0312024__b1151191723014">always</strong>: fsync() is called after every write to the AOF. This mode is very slow, but also very safe.</li><li id="dcs-ug-0312024__li6302154710131"><strong id="dcs-ug-0312024__b515314267304">everysec</strong>: fsync() is called once per second, ensuring both data security and performance.</li></ul>
</li></ul>
<div class="note" id="dcs-ug-0312024__note49251651915"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dcs-ug-0312024__p892141615199">Currently, the <strong id="dcs-ug-0312024__b222182133114">appendonly</strong> and <strong id="dcs-ug-0312024__b101461917163119">appendfsync</strong> parameters can be modified on the console only for master/standby and Redis 4.0 and later Redis Cluster instances.</p>
</div></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dcs-ug-0312022.html">Managing DCS Instances</a></div>
</div>
</div>