yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
93d856d5c56dc6a5b27380fe001d75f16fabcfb6
doc-exports/docs/css/umn/css_01_0056.html
zhengxiu 93d856d5c5 css umn 25.6.0 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: zhengxiu <zhengxiu@huawei.com>
Co-committed-by: zhengxiu <zhengxiu@huawei.com>
2025-11-25 11:34:43 +00:00

616 lines
68 KiB
HTML
Raw 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="EN-US_TOPIC_0000002353029832"></a><a name="EN-US_TOPIC_0000002353029832"></a>
<h1 class="topictitle1">Configuring Flow Control for an OpenSearch Cluster</h1>
<div id="body0000002353029832"><p id="EN-US_TOPIC_0000002353029832__p352564532517">Configure flow control policies for your OpenSearch cluster in both the inbound and outbound directions, ensuring cluster stability by safeguarding against abnormal traffic.</p>
<div class="p" id="EN-US_TOPIC_0000002353029832__p0807832122711">An OpenSearch cluster can become overloaded due to traffic surges, malicious requests, and internal resource competition, which can even lead to node failures. Through policies like client request throttling, write backpressure, and traffic pattern analysis, flow control ensures proper resource allocation, thereby protecting clusters from overload. It covers the following scenarios:<ul id="EN-US_TOPIC_0000002353029832__ul617310410278"><li id="EN-US_TOPIC_0000002353029832__li417354192717">High-concurrency write handling: mitigates the risk of out-of-memory (OOM) exceptions under heavy write loads.</li><li id="EN-US_TOPIC_0000002353029832__li11731041112713">Security defense: controls access by IP address using both blacklists and whitelists.</li><li id="EN-US_TOPIC_0000002353029832__li1817316417271">Emergency response: blocks malicious or abnormal traffic in one click.</li><li id="EN-US_TOPIC_0000002353029832__li16173124172719">Performance optimization: optimizes flow control thresholds and policies based on collected statistics.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000002353029832__section20798162114246"><h4 class="sectiontitle">How the Feature Works</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002353029832__table184021944184915" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Flow control policies</caption><thead align="left"><tr id="EN-US_TOPIC_0000002353029832__row154031944104913"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.4.1.1"><p id="EN-US_TOPIC_0000002353029832__p8403104418494">Policy</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.00000000000001%" id="mcps1.3.3.2.2.4.1.2"><p id="EN-US_TOPIC_0000002353029832__p6403344154917">What It Does</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.2.2.4.1.3"><p id="EN-US_TOPIC_0000002353029832__p840364434913">Details</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002353029832__row140384444912"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__p740317443499">HTTP/HTTPS flow control</p>
</td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__p1378944212018">Controls client access traffic using blacklists and whitelists, an upper limit on concurrent connections, and a rate limit on new connection attempts.</p>
<ul id="EN-US_TOPIC_0000002353029832__ul17667114643212"><li id="EN-US_TOPIC_0000002353029832__li1866734673219">Blacklists and whitelists: A whitelist takes precedence over a blacklist. If an IP address is on both lists, it is allowed. Requests sent through blacklisted connections will be ignored.</li><li id="EN-US_TOPIC_0000002353029832__li14667646113216">Concurrent connection limit: Limits the total number of HTTP connections per second to prevent overload.</li><li id="EN-US_TOPIC_0000002353029832__li1066720467326">New connection limit: Limits the number of new connections that can be set up per second. The warmup_period parameter protects against connection floods, allowing traffic to grow gradually and steadily.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p46431027103819"><a href="#EN-US_TOPIC_0000002353029832__section1023014371242">Configuring HTTP/HTTPS Flow Control</a></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row940304434916"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__p640374454910">Memory flow control</p>
</td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__p1038477153312">When the heap memory usage exceeds a pre-defined threshold (for example, 80%), the system stops receiving large requests, and garbage collection (GC) is triggered to reclaim memory.</p>
<p id="EN-US_TOPIC_0000002353029832__p23841716332">Write traffic is throttled by setting the backpressure factor (in_flight_factor) and the maximum delay for request handling (max).</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p764122710387"><a href="#EN-US_TOPIC_0000002353029832__section12926193210818">Configuring Memory-based Flow Control</a></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row1352240193313"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__p166001174338">One-click traffic blocking</p>
</td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__p75235018331">When enabled, the system immediately disconnects all client connections, but not those used for OpenSearch Dashboards access or O&amp;M and monitoring APIs, in order to restore the cluster.</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p652340173314"><a href="#EN-US_TOPIC_0000002353029832__section364216459204">Configuring One-Click Traffic Blocking</a></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row2099331233318"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__p13993181223311">Request statistics sampling and analysis</p>
</td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__p19931012193310">Records request metrics (such as bulk writes and queries) by client IP address, and exposes them via a statistics API to evaluate the cluster load and proactively identify abnormal traffic patterns.</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p0993101233317"><a href="#EN-US_TOPIC_0000002353029832__section846243514132">Configuring Request Statistics Sampling and Analysis</a></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row574101514333"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__p11749154332">Access logging</p>
</td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__p1273024619579">Records the URLs and bodies of HTTP/HTTPS requests for cluster load and client request analysis.</p>
<p id="EN-US_TOPIC_0000002353029832__p133591014185914">Access logs can also be saved to files (that is, persisted to disk) to facilitate troubleshooting and performance analysis.</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.4.1.3 "><ul id="EN-US_TOPIC_0000002353029832__ul113455417583"><li id="EN-US_TOPIC_0000002353029832__li17134254135813"><a href="#EN-US_TOPIC_0000002353029832__section1626791610277">Configuring Access Logging</a></li><li id="EN-US_TOPIC_0000002353029832__li113419546589"><a href="#EN-US_TOPIC_0000002353029832__section072285622916">Configuring Access Logging in Files</a></li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002353029832__section1995816338248"><h4 class="sectiontitle">Constraints</h4><ul id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001268594569_ul1969619523572"><li id="EN-US_TOPIC_0000002353029832__li2806659111320">Only OpenSearch 2.19.0 supports flow control.</li><li id="EN-US_TOPIC_0000002353029832__li155602458257">Enabling flow control may compromise cluster and node performance. For example, memory-based flow control may cause query failures on OpenSearch Dashboards.</li><li id="EN-US_TOPIC_0000002353029832__li14132113914439">Configuring too many paths for memory-based flow control has a significant impact on performance.</li><li id="EN-US_TOPIC_0000002353029832__li615072744313">Enabling access logging will hurt cluster performance.</li><li id="EN-US_TOPIC_0000002353029832__li169134884414">After flow control policies are enabled, excess or non-compliant requests are rejected directly.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000002353029832__section14917133118375"><h4 class="sectiontitle">Logging In to OpenSearch Dashboards</h4><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_p13118645151118">Log in to OpenSearch Dashboards and go to the command execution page. OpenSearch clusters support multiple access methods. This topic uses OpenSearch Dashboards as an example to describe the operation procedures.</p>
<ol id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_ol511804517115"><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_li111185453113"><span id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_ph134648105316">Log in to the CSS management console.</span></li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_li1711804571114">In the navigation pane on the left, choose <span class="uicontrol" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_uicontrol1511834581115"><b>Clusters &gt; OpenSearch</b></span>.</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_li201181045151113">In the cluster list, find the target cluster, and click <strong id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_b8963520674129">Dashboards</strong> in the <strong id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_b1363282744129">Operation</strong> column to log in to OpenSearch Dashboards.</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_li811824512111">In the left navigation pane, choose <strong id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_b45261424710">Dev Tools</strong>.<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000002338102386_p539424154519">The left part of the console is the command input box, and the triangle icon in its upper-right corner is the execution button. The right part shows the execution result.</p>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000002353029832__section1023014371242"><a name="EN-US_TOPIC_0000002353029832__section1023014371242"></a><a name="section1023014371242"></a><h4 class="sectiontitle">Configuring HTTP/HTTPS Flow Control</h4><p id="EN-US_TOPIC_0000002353029832__p16590102816505">Control client access traffic using blacklists and whitelists, an upper limit on concurrent connections, and a rate limit on new connection attempts.</p>
<ol id="EN-US_TOPIC_0000002353029832__ol764618520817"><li id="EN-US_TOPIC_0000002353029832__li96466521484">Enable HTTP/HTTPS flow control.<pre class="screen" id="EN-US_TOPIC_0000002353029832__screen4250194796">PUT /_cluster/settings
{
"persistent": {
"flowcontrol.http.enabled": true,
"flowcontrol.http.allow": ["<em id="EN-US_TOPIC_0000002353029832__i2025014419912">192.168.0.1/24</em>", "<em id="EN-US_TOPIC_0000002353029832__i52507417911">192.168.2.1/24</em>"],
"flowcontrol.http.deny": "<em id="EN-US_TOPIC_0000002353029832__i125015418914">192.168.1.1/24</em>",
"flowcontrol.http.concurrent": <em id="EN-US_TOPIC_0000002353029832__i92501246919">1000</em>,
"flowcontrol.http.newconnect": <em id="EN-US_TOPIC_0000002353029832__i182501849911">1000</em>,
"flowcontrol.http.warmup_period": <em id="EN-US_TOPIC_0000002353029832__i52504411917">0</em>
}
}</pre>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_table131951219400" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters for configuring HTTP/HTTPS flow control</caption><thead align="left"><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_row161965164016"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.6.3.1.2.2.4.1.1"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p61968134011">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.6.3.1.2.2.4.1.2"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p71961116401">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.6.3.1.2.2.4.1.3"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p111961018403">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_row1319619174010"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.6.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p1119661194016">flowcontrol.http.enabled</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.6.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p51961214407">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p1468611541713">Whether to enable HTTP/HTTPS flow control. Enabling it may impact node performance.</p>
<ul id="EN-US_TOPIC_0000002353029832__ul6855143719218"><li id="EN-US_TOPIC_0000002353029832__li385517373211">true: Enable HTTP/HTTPS flow control.</li><li id="EN-US_TOPIC_0000002353029832__li685512371327">false (default): Disable HTTP/HTTPS flow control.</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_row1196201174015"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.6.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p5196813408">flowcontrol.http.allow</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.6.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p219613114408">List&lt;String&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p1427748174618">A whitelist of client IP addresses or CIDR blocks that are allowed to access the cluster, supporting:</p>
<ul id="EN-US_TOPIC_0000002353029832__ul122641377195"><li id="EN-US_TOPIC_0000002353029832__li142648710198">Individual IP addresses, for example, <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue023181718181"><b>192.18.0.1</b></span>.</li><li id="EN-US_TOPIC_0000002353029832__li1026519715191">CIDR blocks, for example, <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue145051531101816"><b>192.168.0.0/24</b></span>.</li><li id="EN-US_TOPIC_0000002353029832__li1526513771911">Multiple IP addresses or CIDR blocks separated by commas (,), for example, <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue2013714111199"><b>192.168.0.1/24, 192.168.2.1/24</b></span>.</li></ul>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p191969174015">The default is an empty list, indicating no whitelist.</p>
<p id="EN-US_TOPIC_0000002353029832__p563362882410">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue2040724853416"><b>null</b></span> restores the default value.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_row171962111401"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.6.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p10196719403">flowcontrol.http.deny</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.6.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p11196151184013">List&lt;String&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p101131735121110">A blacklist of client IP addresses or CIDR blocks that are not allowed to access the cluster. A whitelist takes precedence over a blacklist. A blacklist supports the following:</p>
<ul id="EN-US_TOPIC_0000002353029832__ul4626141710122"><li id="EN-US_TOPIC_0000002353029832__li1462612170122">Individual IP addresses, for example, <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue1072410532409"><b>192.18.0.1</b></span>.</li><li id="EN-US_TOPIC_0000002353029832__li46271617171214">CIDR blocks, for example, <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue0217457184013"><b>192.168.0.0/24</b></span>.</li><li id="EN-US_TOPIC_0000002353029832__li1562781791219">Multiple IP addresses or CIDR blocks separated by commas (,), for example, <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue186021906412"><b>192.168.0.1/24, 192.168.2.1/24</b></span>.</li></ul>
<p id="EN-US_TOPIC_0000002353029832__p75561922111218">The default is an empty list, indicating no blacklist.</p>
<p id="EN-US_TOPIC_0000002353029832__p538011281252">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue184108483342"><b>null</b></span> restores the default value.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_row1619613194017"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.6.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p11968194014">flowcontrol.http.concurrent</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.6.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p819631194020">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p1623202511315">Maximum number of concurrent HTTP/HTTPS connections that can be handled by each node per second. The default value is the number of available node vCPUs multiplied by 600.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_row719671174016"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.6.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p171961513405">flowcontrol.http.newconnect</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.6.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p161969118405">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p162706187172">Maximum number of new HTTP/HTTPS connections that can be created per second per node.</p>
<p id="EN-US_TOPIC_0000002353029832__p34626571159">The default value is the number of available node vCPUs multiplied by 200.</p>
<p id="EN-US_TOPIC_0000002353029832__p1850543142511">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue194131348113420"><b>null</b></span> restores the default value.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_row1519651144012"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.6.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p719612111408">flowcontrol.http.warmup_period</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.6.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p7196171144019">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p24244411216">A grace period during which a system gradually ramp up from accepting zero HTTP/HTTPS requests to its full, maximum capacity.</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_p201961612402">Value range: 0–10000</p>
<p id="EN-US_TOPIC_0000002353029832__p14499110202219">Unit: ms</p>
<p id="EN-US_TOPIC_0000002353029832__p14790191815229">The default value is 0, indicating that there is no such warm-up period, and the maximum rate can be reached instantly.</p>
<p id="EN-US_TOPIC_0000002353029832__p208817355258">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue5416104803412"><b>null</b></span> restores the default value.</p>
<p id="EN-US_TOPIC_0000002353029832__p186301421101915">For example, if <span class="parmname" id="EN-US_TOPIC_0000002353029832__parmname11347153401218"><b>flowcontrol.http.newconnect</b></span> is set to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue1095810385127"><b>100</b></span> and <span class="parmname" id="EN-US_TOPIC_0000002353029832__parmname109476434127"><b>flowcontrol.http.warmup_period</b></span> is set to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue528714881211"><b>5000ms</b></span>, it takes 5 seconds for the system to reach 100 new connections per second.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_li96343413449">Disable HTTP/HTTPS flow control.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485533945_en-us_topic_0000001228531978_screen463412415444">PUT /_cluster/settings
{
"persistent": {
"flowcontrol.http.enabled": false
}
}</pre>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000002353029832__section12926193210818"><a name="EN-US_TOPIC_0000002353029832__section12926193210818"></a><a name="section12926193210818"></a><h4 class="sectiontitle">Configuring Memory-based Flow Control</h4><p id="EN-US_TOPIC_0000002353029832__p553818014514">Enable write throttling to mitigate the risk of OOM exceptions when the heap memory usage of a node exceeds a predefined threshold.</p>
<ol id="EN-US_TOPIC_0000002353029832__ol12925259131314"><li id="EN-US_TOPIC_0000002353029832__li0925145919136">Enable memory-based flow control.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_screen1857516140228">PUT /_cluster/settings
{
"persistent": {
"flowcontrol.memory.enabled": true,
"flowcontrol.memory.heap_limit": "80%"
}
}</pre>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_table1376624125014" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Memory-based flow control parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_row071224195017"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.7.3.1.2.2.4.1.1"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p147182455018">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.7.3.1.2.2.4.1.2"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p187122413507">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.7.3.1.2.2.4.1.3"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p471152425019">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_row1772172425018"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p1172924155011">flowcontrol.memory.enabled</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.7.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p3721024155016">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.1.2.2.4.1.3 "><div class="p" id="EN-US_TOPIC_0000002353029832__p0416118201511">Whether to enable memory-based flow control. When enabled, node heap memory usage is monitored and a threshold is set, and writes are throttled when this threshold is reached.<ul id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_ul57202413502"><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_li177262415018">true: Enable memory-based flow control.</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_li6721124185015">false (default): Disable memory-based flow control.</li></ul>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_row1673162455019"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p57262417501">flowcontrol.memory.heap_limit</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.7.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p77212248507">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p1553612183118">Node heap memory usage threshold. When this threshold is exceeded, a write backpressure mechanism is triggered.</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p872182485012">Value range: 10%–100%</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p772324105019">The default value 90% of <span class="parmname" id="EN-US_TOPIC_0000002353029832__parmname1321192211333"><b>flowcontrol.memory.heap_limit</b></span> is a conservative threshold. When the heap memory usage exceeds 90%, the system stops accepting client requests that exceed 64 KB, until heap memory usage decreases. Once the heap memory usage decreases to 85%, client data equivalent to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue20106031113111"><b>5% x maximum heap memory capacity</b></span> can be read. If the heap memory usage stays above 90% for a long time, client requests cannot be processed. In this case, garbage collection is triggered until the heap memory usage drops below this threshold.</p>
<p id="EN-US_TOPIC_0000002353029832__p1233215418339">Generally, you can set this threshold to 80% or less to ensure that cluster nodes have reserved some heap memory for operations besides data writing, such as segment merges.</p>
<p id="EN-US_TOPIC_0000002353029832__p674145195015">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue134191487342"><b>null</b></span> restores the default value.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_row107342416503"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p12739246508">flowcontrol.holding.in_flight_factor</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.7.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p6731224185015">Float</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p20368757133513">Backpressure factor, which controls the sensitivity of memory-based backpressure. A larger value indicates more powerful write throttling.</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p11731324155015">Value range: ≥ 0.5</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p1473122417506">The default value is <strong id="EN-US_TOPIC_0000002353029832__b154510209353214">1.0</strong>.</p>
<p id="EN-US_TOPIC_0000002353029832__p1693997195017">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue144221548163414"><b>null</b></span> restores the default value.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_row12736245506"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p2073924135018">flowcontrol.holding.max</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.7.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p1173724135015">TimeValue</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p36261323183712">Maximum request handling delay allowed before requests are handled according to the policy defined by <span class="parmname" id="EN-US_TOPIC_0000002353029832__parmname1068833917386"><b>flowcontrol.holding.max_strategy</b></span>.</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p1673112425012">Value range: ≥ 15s</p>
<p id="EN-US_TOPIC_0000002353029832__p116395105392">Unit: second</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p37319243503">Default value: 60s</p>
<p id="EN-US_TOPIC_0000002353029832__p14820118135015">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue164244486348"><b>null</b></span> restores the default value.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_row1174122416504"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p147372405013">flowcontrol.holding.max_strategy</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.7.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p147472485010">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p116218599416">Handling policy for requests delayed longer than <strong id="EN-US_TOPIC_0000002353029832__b122117259712">flowcontrol.holding.max</strong>.</p>
<ul id="EN-US_TOPIC_0000002353029832__ul6463211154413"><li id="EN-US_TOPIC_0000002353029832__li846319117447"><strong id="EN-US_TOPIC_0000002353029832__b15387119102">keep</strong> (default): Keep the backpressure status while waiting for the memory usage to drop. The server determines when to execute the requests based on real-time memory usage.</li><li id="EN-US_TOPIC_0000002353029832__li14463151154411"><strong id="EN-US_TOPIC_0000002353029832__b1898118410104">soft</strong>: Forcibly execute the requests, but the <strong id="EN-US_TOPIC_0000002353029832__b126141413151020">inFlight</strong> circuit breaker gets to decide whether to reject them.</li><li id="EN-US_TOPIC_0000002353029832__li5463121144416"><strong id="EN-US_TOPIC_0000002353029832__b13309161891010">hard</strong>: Reject the requests immediately and disconnect client connections.</li></ul>
<p id="EN-US_TOPIC_0000002353029832__p15612485012">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue7427154853415"><b>null</b></span> restores the default value.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_row5751124115018"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p974102495015">flowcontrol.memory.once_free_max</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.7.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p675112495013">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p150820216456">Maximum memory that can be made available at a time for a re-enabled request queue. This parameter can be configured to prevent cluster overload caused by a flood of incoming requests.</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p1775122414500">Value range: 1%–50%</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p4751024145010">The default value is 5%.</p>
<p id="EN-US_TOPIC_0000002353029832__p1677712267503">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue124302482342"><b>null</b></span> restores the default value.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_row17692475019"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p27592417509">flowcontrol.memory.nudges_gc</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.7.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_p137512244504">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p139221520184710">Whether to trigger garbage collection (GC) to reclaim memory when the write pressure is too high. (The backpressure connection pool is checked every second. The write pressure is considered high if all existing connections are blocked and new write requests cannot be accepted.)</p>
<ul id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_ul147516243503"><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_li1375112419506">true (default): Trigger GC.</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_li137512416505">false: Not to trigger GC.</li></ul>
<p id="EN-US_TOPIC_0000002353029832__p4944832205017">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue134331489346"><b>null</b></span> restores the default value.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000002353029832__li39259597131">Disable memory-based flow control.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001485373445_screen38095315235">PUT /_cluster/settings
{
"persistent": {
"flowcontrol.memory.enabled": false
}
}</pre>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000002353029832__section364216459204"><a name="EN-US_TOPIC_0000002353029832__section364216459204"></a><a name="section364216459204"></a><h4 class="sectiontitle">Configuring One-Click Traffic Blocking</h4><p id="EN-US_TOPIC_0000002353029832__p29879153523">In case of emergencies, the system immediately disconnects all client connections (excluding those used for OpenSearch Dashboards access or O&amp;M and monitoring APIs) to restore clusters.</p>
<ol id="EN-US_TOPIC_0000002353029832__ol10755164012261"><li id="EN-US_TOPIC_0000002353029832__li6755104018263">Enable one-click traffic blocking.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435336968_screen32595165917">PUT /_cluster/settings
{
"persistent": {
"flowcontrol.break.enabled": true
}
}</pre>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002353029832__table65701531145114" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Parameters for configuring one-click traffic blocking</caption><thead align="left"><tr id="EN-US_TOPIC_0000002353029832__row65708314517"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.8.3.1.2.2.4.1.1"><p id="EN-US_TOPIC_0000002353029832__p357011318512">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.8.3.1.2.2.4.1.2"><p id="EN-US_TOPIC_0000002353029832__p2570163175110">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.8.3.1.2.2.4.1.3"><p id="EN-US_TOPIC_0000002353029832__p1257093115519">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002353029832__row4570531145118"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.8.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__p066804225115">flowcontrol.break.enabled</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.8.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__p123913184525">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p593618575535">Whether to enable one-click traffic blocking (similar to a circuit breaker). When enabled, the system immediately disconnects all client connections, but not those used for OpenSearch Dashboards access or O&amp;M and monitoring APIs.</p>
<ul id="EN-US_TOPIC_0000002353029832__ul19239918175217"><li id="EN-US_TOPIC_0000002353029832__li36205366548">true: Enable one-click disconnection.</li><li id="EN-US_TOPIC_0000002353029832__li19239181815211">false (default): Disable one-click disconnection.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000002353029832__li6755040112610">Disable one-click disconnection:<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435336968_screen125153596">PUT /_cluster/settings
{
"persistent": {
"flowcontrol.break.enabled": false
}
}</pre>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000002353029832__section846243514132"><a name="EN-US_TOPIC_0000002353029832__section846243514132"></a><a name="section846243514132"></a><h4 class="sectiontitle">Configuring Request Statistics Sampling and Analysis</h4><p id="EN-US_TOPIC_0000002353029832__p1665810359">Collect request metrics by client IP address to help identify abnormal traffic patterns.</p>
<ol id="EN-US_TOPIC_0000002353029832__ol4475813132113"><li id="EN-US_TOPIC_0000002353029832__li547591314210">Enable request statistics sampling.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001229251898_screen11422663329">PUT _cluster/settings
{
"transient": {
"flowcontrol.log.access.enabled": true
}
}</pre>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_table119653339296" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Parameters for request statistics sampling</caption><thead align="left"><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_row4965733122914"><th align="left" class="cellrowborder" valign="top" width="33.5033503350335%" id="mcps1.3.9.3.1.2.2.4.1.1"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p2966183317293">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.58165816581658%" id="mcps1.3.9.3.1.2.2.4.1.2"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p179661933182914">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="49.91499149914991%" id="mcps1.3.9.3.1.2.2.4.1.3"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p8966123313297">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_row59660338299"><td class="cellrowborder" valign="top" width="33.5033503350335%" headers="mcps1.3.9.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p653813441717">flowcontrol.log.access.enabled</p>
</td>
<td class="cellrowborder" valign="top" width="16.58165816581658%" headers="mcps1.3.9.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p19538248171">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="49.91499149914991%" headers="mcps1.3.9.3.1.2.2.4.1.3 "><div class="p" id="EN-US_TOPIC_0000002353029832__p16687209192411">Whether to enable request statistics sampling, that is, whether to collect request metrics (such as bulk writes and search/msearch requests) by client IP address.<ul id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_ul1710319303196"><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_li5103133010198">true: Enable request statistics sampling.</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_li1748743371912">false (default): Disable request statistics sampling.</li></ul>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_row7966933172918"><td class="cellrowborder" valign="top" width="33.5033503350335%" headers="mcps1.3.9.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p153818418177">flowcontrol.log.access.count</p>
</td>
<td class="cellrowborder" valign="top" width="16.58165816581658%" headers="mcps1.3.9.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p185383413173">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="49.91499149914991%" headers="mcps1.3.9.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p187171757806">Maximum number of client IP addresses sampled.</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p1953824111712">Value range: 0–100</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p5538144191712">Default value: <strong id="EN-US_TOPIC_0000002353029832__b155757750053214">10</strong></p>
<p id="EN-US_TOPIC_0000002353029832__p2087865739">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue650922216349"><b>null</b></span> restores the default value.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000002353029832__li17513101815313">Check the sampled statistics.<ul id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435180316_ul19124627174116"><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435180316_li1124132724114">Check the flow control status of all nodes.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435180316_screen39443424212">GET /_nodes/stats/filter/v2</pre>
</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435180316_li1931146103111">Check the flow control details of all nodes.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435180316_screen123174618312">GET /_nodes/stats/filter/v2?detail</pre>
</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435180316_li6489194354113">Check the flow control status of a specified node.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435180316_screen9507113922510">GET /_nodes/<em id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435180316_i8507123972519">{nodeId}</em>/stats/filter/v2</pre>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435180316_p647618221453"><span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue93001839183115"><b>{nodeId}</b></span> indicates the node ID.</p>
</li></ul>
<div class="p" id="EN-US_TOPIC_0000002353029832__p20433144220284">Example response:<pre class="screen" id="EN-US_TOPIC_0000002353029832__screen276044142816">{
"_nodes" : {
"total" : 1,
"successful" : 1,
"failed" : 0
},
"cluster_name" : "css-xxxx",
"nodes" : {
"d3qnVIpPTtSoadkV0LQEkA" : {
"name" : "css-xxxx-ess-esn-1-1",
"host" : "192.168.x.x",
"timestamp" : 1672236425112,
"flow_control" : {
"http" : {
"current_connect" : 52,
"rejected_concurrent" : 0,
"rejected_rate" : 0,
"rejected_black" : 0,
"rejected_breaker" : 0
},
"access_items" : [
{
"remote_address" : "10.0.0.x",
"search_count" : 0,
"bulk_count" : 0,
"other_count" : 4
}
],
"holding_requests" : 0
}
}
}
}</pre>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002353029832__table27611841152812" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Response parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000002353029832__row676064112286"><th align="left" class="cellrowborder" valign="top" width="28.59%" id="mcps1.3.9.3.2.2.2.2.3.1.1"><p id="EN-US_TOPIC_0000002353029832__p13760114119285">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="71.41%" id="mcps1.3.9.3.2.2.2.2.3.1.2"><p id="EN-US_TOPIC_0000002353029832__p10760184118281">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002353029832__row4760741202819"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p12760164112284">current_connect</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p276044115287">Number of HTTP connections to a node, which is recorded regardless of whether flow control is enabled. This value is equivalent to the <strong id="EN-US_TOPIC_0000002353029832__b38125374653214">current_open</strong> value of <strong id="EN-US_TOPIC_0000002353029832__b124603783253214">GET /_nodes/stats/http</strong> API. It shows the current client connections of each node.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row7760041172816"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p97601141142815">rejected_concurrent</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p2025014616582">Number of concurrent connections rejected during flow control.</p>
<p id="EN-US_TOPIC_0000002353029832__p1252956115811">This metric is available only when <span class="parmname" id="EN-US_TOPIC_0000002353029832__parmname114957511705"><b>flowcontrol.http.enabled</b></span> is set to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue103291754708"><b>true</b></span>. The count will not be cleared when flow control is disabled.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row9760541182819"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p1276004120282">rejected_rate</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p1557817586211">Number of new connections rejected during flow control.</p>
<p id="EN-US_TOPIC_0000002353029832__p113641652073">This metric is available only when <span class="parmname" id="EN-US_TOPIC_0000002353029832__parmname14364185214711"><b>flowcontrol.http.enabled</b></span> is set to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue7364205212720"><b>true</b></span>. The count will not be cleared when flow control is disabled.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row197601341112815"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p47601241112813">rejected_black</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p1940511118819">Number of new connections rejected by a preconfigured blacklist during flow control.</p>
<p id="EN-US_TOPIC_0000002353029832__p154052119812">This metric is available only when <span class="parmname" id="EN-US_TOPIC_0000002353029832__parmname104051511584"><b>flowcontrol.http.enabled</b></span> is set to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue240512111586"><b>true</b></span>. The count will not be cleared when flow control is disabled.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row12760114119289"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p1076074115282">rejected_breaker</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p1376015415289">Number of new connections rejected during one-click traffic blocking.</p>
<p id="EN-US_TOPIC_0000002353029832__p185016230146">This metric is available only when <span class="parmname" id="EN-US_TOPIC_0000002353029832__parmname19686102341419"><b>flowcontrol.break.enabled</b></span> is set to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue17686192314143"><b>true</b></span>. The count will not be cleared when one-click traffic blocking is disabled.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row814425345319"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p61449531535">access_items</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p0467203191015">IP addresses of clients that recently accessed the cluster.</p>
<p id="EN-US_TOPIC_0000002353029832__p25081033101010">The number of client IP addresses sampled is determined by <span class="parmname" id="EN-US_TOPIC_0000002353029832__parmname243318141110"><b>flowcontrol.log.access.count</b></span>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row18760144102817"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p1776064132810">remote_address</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p1576012412288">IP addresses and the number of requests.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row147614419285"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p1760164118281">search_count</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p176114113283">Number of times a client accessed a database using <strong id="EN-US_TOPIC_0000002353029832__b161894942453214">_search</strong> and <strong id="EN-US_TOPIC_0000002353029832__b121952424853214">_msearch</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row127611541102815"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p11761941172812">bulk_count</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p8761154112817">Number of times a client accessed a database using <strong id="EN-US_TOPIC_0000002353029832__b161906101953214">_bulk</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row67611841122817"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p1976144115283">other_count</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p376114115288">Number of times a client accessed a database using other request methods.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row17993457125518"><td class="cellrowborder" valign="top" width="28.59%" headers="mcps1.3.9.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p209931157165510">holding_requests</p>
</td>
<td class="cellrowborder" valign="top" width="71.41%" headers="mcps1.3.9.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p1899318573555">Number of connections to the current node where writes are halted due to flow control.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</li><li id="EN-US_TOPIC_0000002353029832__li547581314213">Disable request statistics sampling.<pre class="screen" id="EN-US_TOPIC_0000002353029832__screen347116118229">PUT /_cluster/settings
{
"persistent": {
"flowcontrol.log.access.enabled": false
}
}</pre>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000002353029832__section1626791610277"><a name="EN-US_TOPIC_0000002353029832__section1626791610277"></a><a name="section1626791610277"></a><h4 class="sectiontitle">Configuring Access Logging</h4><p id="EN-US_TOPIC_0000002353029832__p19370103914615">When access logging is enabled, the system records the URLs and bodies of HTTP/HTTPS requests for cluster load and request analysis.</p>
<ol id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_ol1451314268310"><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_li13513102653113">Enable access logging.<ul id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_ul14793171816334"><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_li37931181334">Enable access logging for all nodes in a cluster.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_screen17931818123313">PUT /_access_log?duration_limit=30s&amp;capacity_limit=1mb</pre>
</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_li0793111893316">Enable access logging for a specified node in a cluster.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_screen379391812337">PUT /_access_log/<em id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_i1679351813312">{nodeId}</em>?duration_limit=30s&amp;capacity_limit=1mb</pre>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p8794141853314"><span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue56872239318"><b>{nodeId}</b></span> indicates the node ID.</p>
</li></ul>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_table14438151713712" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Parameters for enabling access logging</caption><thead align="left"><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_row134385172373"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.10.3.1.2.2.4.1.1"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p94387177375">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.10.3.1.2.2.4.1.2"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p35341047113710">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.10.3.1.2.2.4.1.3"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p84381717153717">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_row10438717163713"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p17438317183719">duration_limit</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.10.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p145341647133719">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p164381817183717">Maximum duration of access log records. When this duration is reached, access logging stops.</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p154384172374">Value range: 10 to 120</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p9438111793716">Unit: s</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p0438417143712">The default value is <strong id="EN-US_TOPIC_0000002353029832__b144860997653214">30</strong>.</p>
<p id="EN-US_TOPIC_0000002353029832__p1029918901012">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue1743674823412"><b>null</b></span> restores the default value.</p>
<p id="EN-US_TOPIC_0000002353029832__p13578954098">Access logging stops when either <strong id="EN-US_TOPIC_0000002353029832__b210082167053214">duration_limit</strong> or <strong id="EN-US_TOPIC_0000002353029832__b171316252853214">capacity_limit</strong> is reached.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_row34381417173716"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p18438201753718">capacity_limit</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.10.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p853404783711">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p9438111753718">Maximum memory capacity for recording access logs. When the size of an access log reaches this limit, access logging stops.</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p743820171376">Value range: 1 to 5</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p4438161714372">Unit: MB</p>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p1343871763718">The default value is <strong id="EN-US_TOPIC_0000002353029832__b156031994753214">1</strong>.</p>
<p id="EN-US_TOPIC_0000002353029832__p490851014107">Setting this parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue1843904814342"><b>null</b></span> restores the default value.</p>
<p id="EN-US_TOPIC_0000002353029832__p7474195615912">Access logging stops when either <strong id="EN-US_TOPIC_0000002353029832__b173643688053214">duration_limit</strong> or <strong id="EN-US_TOPIC_0000002353029832__b109642265453214">capacity_limit</strong> is reached.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_li148131484332">Check access logs.<ul id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_ul1492754423311"><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_li139271444163318">Check the access logs of all nodes in a cluster.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_screen9927164493314">GET /_access_log</pre>
</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_li13927144403310">Check the access logs of a specified cluster node.<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_screen1092704483317">GET /_access_log/<em id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_i209271044183311">{nodeId}</em></pre>
<p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p2927164443316"><span class="parmvalue" id="EN-US_TOPIC_0000002353029832__parmvalue0573183063310"><b>{nodeId}</b></span> indicates the node ID.</p>
</li></ul>
<div class="p" id="EN-US_TOPIC_0000002353029832__p5405653133319">Example response:<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_screen195443596430">{
"_nodes" : {
"total" : 1,
"successful" : 1,
"failed" : 0
},
"cluster_name" : "css-flowcontroller",
"nodes" : {
"8x-ZHu-wTemBQwpcGivFKg" : {
"name" : "css-flowcontroller-ess-esn-1-1",
"host" : "10.0.0.98",
"count" : 2,
"access" : [
{
"time" : "2021-02-23 02:09:50",
"remote_address" : "/10.0.0.98:28191",
"url" : "/_access/security/log?pretty",
"method" : "GET",
"content" : ""
},
{
"time" : "2021-02-23 02:09:52",
"remote_address" : "/10.0.0.98:28193",
"url" : "/_access/security/log?pretty",
"method" : "GET",
"content" : ""
}
]
}
}
}</pre>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_table79421457173012" frame="border" border="1" rules="all"><caption><b>Table 8 </b>Response parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_row12943105753011"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.10.3.2.2.2.2.3.1.1"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p1494335719307">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70%" id="mcps1.3.10.3.2.2.2.2.3.1.2"><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p199431457183013">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_row194320579307"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p894310579302">name</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.10.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p59431557113017">Node name</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_row69435575302"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p09431057113020">host</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.10.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p8943657193020">Node IP address</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_row694345717303"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p13943115753016">count</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.10.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p494375723012">Number of node access requests in a statistical period</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_row1994312574305"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p189431657143012">access</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.10.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_p13943125716308">Details about node access requests in a statistical period</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row167108335102"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p1339393817129">time</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.10.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p639363818121">Request time</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row165477383109"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p63931638151215">remote_address</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.10.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p16393103821212">Source IP address and port number in the request</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row83491940151015"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p839323814127">url</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.10.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p10393338131217">Original URL of the request</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row4815114114107"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p1939383831217">method</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.10.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p039383817128">Request method</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002353029832__row1340310430108"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.10.3.2.2.2.2.3.1.1 "><p id="EN-US_TOPIC_0000002353029832__p83931389121">content</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.10.3.2.2.2.2.3.1.2 "><p id="EN-US_TOPIC_0000002353029832__p14394133881212">Request content. If the value is an empty string (""), there is no request body.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_li11157142918335">Delete access logs. Logs are recorded in the memory. After reading the logs, you are advised to delete them to reclaim resources.<div class="p" id="EN-US_TOPIC_0000002353029832__p346173410492"><a name="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_li11157142918335"></a><a name="en-us_topic_0000001435340292_li11157142918335"></a>Delete access logs for all nodes:<pre class="screen" id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435340292_screen223415231372">DELETE /_access_log</pre>
</div>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000002353029832__section072285622916"><a name="EN-US_TOPIC_0000002353029832__section072285622916"></a><a name="section072285622916"></a><h4 class="sectiontitle">Configuring Access Logging in Files</h4><p id="EN-US_TOPIC_0000002353029832__p79674713">Access logs can be persisted to disk for troubleshooting and analysis. Use this function sparingly, as it can impact cluster performance. Remember to disable it immediately after resolving the issue.</p>
<ol id="EN-US_TOPIC_0000002353029832__ol871152419322"><li id="EN-US_TOPIC_0000002353029832__li5712245322">Enable access logging in files.<pre class="screen" id="EN-US_TOPIC_0000002353029832__screen282114492348">PUT /_cluster/settings
{
"persistent": {
"flowcontrol.log.file.enabled": true
}
}</pre>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002353029832__table082114917343" frame="border" border="1" rules="all"><caption><b>Table 9 </b>Enable access logging in files</caption><thead align="left"><tr id="EN-US_TOPIC_0000002353029832__row83302171662"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.11.3.1.2.2.4.1.1"><p id="EN-US_TOPIC_0000002353029832__p1331141710611">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.11.3.1.2.2.4.1.2"><p id="EN-US_TOPIC_0000002353029832__p133310171567">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.11.3.1.2.2.4.1.3"><p id="EN-US_TOPIC_0000002353029832__p1533112175616">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_row19966533112920"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.11.3.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p1553811461715">flowcontrol.log.file.enabled</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.11.3.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_p55389481717">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.11.3.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0000002353029832__p165681148111317">Whether to record access logs in files. When enabled, the log of each access request is recorded in files.</p>
<p id="EN-US_TOPIC_0000002353029832__p1570615197353">The log file name is <span class="filepath" id="EN-US_TOPIC_0000002353029832__filepath5376195162365"><b>Cluster name_access_log.log</b></span>. You can check this file only through the log backup function.</p>
<ul id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_ul1015915575192"><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_li616025719198">true: Record access logs in files.</li><li id="EN-US_TOPIC_0000002353029832__en-us_topic_0000001435176996_li91601057111913">false (default): Not to record access logs in files.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000002353029832__li7679839163220">Disable access logging in files.<pre class="screen" id="EN-US_TOPIC_0000002353029832__screen5341356143211">PUT /_cluster/settings
{
"persistent": {
"flowcontrol.log.file.enabled": false
}
}</pre>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="css_01_0095.html">Enhancing Search Capabilities for OpenSearch Clusters</a></div>
</div>
</div>
View Git Blame Copy Permalink