doc-exports/docs/apm/umn/apm_07_0015.html
Li, Qiao 01222743d0 APM2.0 UMN 20230825 version
Reviewed-by: Mützel, Andrea <andrea.muetzel@t-systems.com>
Co-authored-by: Li, Qiao <qiaoli@huawei.com>
Co-committed-by: Li, Qiao <qiaoli@huawei.com>
2024-06-18 07:09:10 +00:00

132 lines
15 KiB
HTML

<a name="apm_07_0015"></a><a name="apm_07_0015"></a>
<h1 class="topictitle1">Configuring the URL Monitoring Item</h1>
<div id="body8662426"><div class="p" id="apm_07_0015__en-us_topic_0000001261891441_p659985693915">On the <strong id="apm_07_0015__en-us_topic_0000001261891441_b132145415469">Modify URL Monitoring Configuration</strong> page, set the following parameters:<div class="caution" id="apm_07_0015__en-us_topic_0000001261891441_note1937981034812"><span class="cautiontitle"><img src="public_sys-resources/caution_3.0-en-us.png"> </span><div class="cautionbody"><p id="apm_07_0015__en-us_topic_0000001261891441_p153792010164818">For security purposes, do not contain sensitive data in headers, URL parameters, cookies, or other parameters.</p>
</div></div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="apm_07_0015__en-us_topic_0000001261891441_table1982462414313" frame="border" border="1" rules="all"><thead align="left"><tr id="apm_07_0015__en-us_topic_0000001261891441_row1882592420432"><th align="left" class="cellrowborder" valign="top" width="14.821482148214821%" id="mcps1.3.1.3.1.4.1.1"><p id="apm_07_0015__en-us_topic_0000001261891441_p1182513242439">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="63.64636463646364%" id="mcps1.3.1.3.1.4.1.2"><p id="apm_07_0015__en-us_topic_0000001261891441_p108252248432">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.532153215321532%" id="mcps1.3.1.3.1.4.1.3"><p id="apm_07_0015__en-us_topic_0000001261891441_p1382511248436">Example</p>
</th>
</tr>
</thead>
<tbody><tr id="apm_07_0015__en-us_topic_0000001261891441_row5825192434315"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p632719408589">Collection Interval</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p1130373185917">The default value is <strong id="apm_07_0015__en-us_topic_0000001261891441_b122851644102211">60s</strong> and cannot be changed.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p53261240105812">60s</p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row184063445812"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p753371114716">Key for Header Value Interception</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p1910492819532">Key specified for collecting values in headers. The collected information can be seen in the trace parameters.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p198261243431">Host</p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row18261024194319"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p282752484310">Key for Parameter Value Interception</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p1482742494318">Key specified for collecting values in URLs. The collected information can be seen in the trace parameters. Take <strong id="apm_07_0015__en-us_topic_0000001261891441_b711613276345">http://127.0.0.1/test?param=123</strong> as an example. If the key is set to <strong id="apm_07_0015__en-us_topic_0000001261891441_b152047149187">param</strong>, value <strong id="apm_07_0015__en-us_topic_0000001261891441_b4110111961812">123</strong> can be seen in the trace parameters.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p48271624194311">param</p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row58271249430"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p28271524174320">Key for Cookie Value Interception</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p146511018124818">Key specified for collecting values in cookies. The collected information can be seen in the trace parameters.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p1582732414314">testKey</p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row0827122414320"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p2827102420431">URL Collection Configuration</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p982792419432">URLs that meet the conditions you set are aggregated. For example, <strong id="apm_07_0015__en-us_topic_0000001261891441_b5393134825314">/rest/v1/test/123</strong> and <strong id="apm_07_0015__en-us_topic_0000001261891441_b770415517534">/rest/v1/test/234</strong> can be aggregated into <strong id="apm_07_0015__en-us_topic_0000001261891441_b6817315542">/rest/v1/test/</strong><em id="apm_07_0015__en-us_topic_0000001261891441_i65191245543">{id}</em>. The configuration method is the same as that described in <a href="apm_07_0014.html#apm_07_0014__en-us_topic_0000001217131578_section195174419328">HttpClient URL Normalization</a>.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p3578139193317"><a href="#apm_07_0015__en-us_topic_0000001261891441_fig469405973013">Figure 1</a></p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row128272241439"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p1182718248435">Blocklist Configuration</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p133651743184912">Data of URLs that meet the conditions you set will not be collected. The configuration method is the same as that described in <a href="apm_07_0014.html#apm_07_0014__en-us_topic_0000001217131578_section195174419328">HttpClient URL Normalization</a>.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p2099814493331"><a href="#apm_07_0015__en-us_topic_0000001261891441_fig469405973013">Figure 1</a></p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row208281224164311"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p0828132410436">Service Code Length</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p138283244435">Maximum length of the response body to be parsed to prevent the performance from being affected. Content that beyond this limit will not be parsed, but corresponding service status codes are regarded as normal by default.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p582820244437">-</p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row68281124164315"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p15828624144317">Key for Service Code Interception</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p118281324144317">Key specified for collecting service status codes. If the custom API returned content is <strong id="apm_07_0015__en-us_topic_0000001261891441_b17299121573916">{"errorCode":500,"errorMsg":"error msg"}</strong>, set this parameter to <strong id="apm_07_0015__en-us_topic_0000001261891441_b187943479423">errorCode</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p4828192417437">errorCode</p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row13648164214504"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p15532194295010">Normal Service Code</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p4532154225013">If this status code is returned, traces are regarded as normal. If other codes are returned, traces are regarded as abnormal.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p05321442165016">-</p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row9643342125020"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p9532942145012">Slow Request Threshold</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p11532144220501">Global response time threshold. The default value is <strong id="apm_07_0015__en-us_topic_0000001261891441_b633915622416">800</strong>. Requests with the response time longer than 800 ms are regarded as slow requests. The sampling ratio of slow requests will be increased.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p17532442165014">-</p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row76378422502"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p1653214211509">URL Configuration</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p14144113705111">Response time threshold separately set for a URL. If the response time of this URL exceeds the threshold, the sampling rate of this URL will be increased. If this parameter is not set, the global slow request threshold is used by default.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p1576565583314"><a href="#apm_07_0015__en-us_topic_0000001261891441_fig469405973013">Figure 1</a></p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row1663618116229"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p186363110220">Error Code</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p113086417425">Options: <strong id="apm_07_0015__en-us_topic_0000001261891441_b6381185293815">400 or greater</strong> and <strong id="apm_07_0015__en-us_topic_0000001261891441_b228550193820">500 or greater</strong> (default). By default, if status code 500 or greater occurs, the system regards that there is an error.</p>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p663781112211">-</p>
</td>
</tr>
<tr id="apm_07_0015__en-us_topic_0000001261891441_row16944619123710"><td class="cellrowborder" valign="top" width="14.821482148214821%" headers="mcps1.3.1.3.1.4.1.1 "><p id="apm_07_0015__en-us_topic_0000001261891441_p29442019103716">URL Automatic Normalization</p>
</td>
<td class="cellrowborder" valign="top" width="63.64636463646364%" headers="mcps1.3.1.3.1.4.1.2 "><p id="apm_07_0015__en-us_topic_0000001261891441_p1983114655117">Example: There are three URL invocations:</p>
<p id="apm_07_0015__en-us_topic_0000001261891441_p38314620517">/get/xxx/a</p>
<p id="apm_07_0015__en-us_topic_0000001261891441_p18318616510">/get/xxx/b</p>
<p id="apm_07_0015__en-us_topic_0000001261891441_p17831568513">/get/xxx/b</p>
<ul id="apm_07_0015__en-us_topic_0000001261891441_ul1517719761618"><li id="apm_07_0015__en-us_topic_0000001261891441_li1742121214165">If this parameter is set to <strong id="apm_07_0015__en-us_topic_0000001261891441_b260445135012">Yes</strong>, URL automatic normalization is enabled.<p id="apm_07_0015__en-us_topic_0000001261891441_p14183141285313">After normalization:</p>
<p id="apm_07_0015__en-us_topic_0000001261891441_p12184912105310">/get/xxx/a 1</p>
<p id="apm_07_0015__en-us_topic_0000001261891441_p1184171211538">/get/xxx/b 2</p>
</li><li id="apm_07_0015__en-us_topic_0000001261891441_li1162751818222">If this parameter is set to <strong id="apm_07_0015__en-us_topic_0000001261891441_b447219312508">No</strong>, URL automatic normalization is disabled.<p id="apm_07_0015__en-us_topic_0000001261891441_p1929911282712">/get/xxx/{p} 3</p>
</li><li id="apm_07_0015__en-us_topic_0000001261891441_li168074151167"><strong id="apm_07_0015__en-us_topic_0000001261891441_b0881152191417">Use default value</strong>: The inherited tag value is preferentially used.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="21.532153215321532%" headers="mcps1.3.1.3.1.4.1.3 "><p id="apm_07_0015__en-us_topic_0000001261891441_p1194516194371">-</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="fignone" id="apm_07_0015__en-us_topic_0000001261891441_fig469405973013"><a name="apm_07_0015__en-us_topic_0000001261891441_fig469405973013"></a><a name="en-us_topic_0000001261891441_fig469405973013"></a><span class="figcap"><b>Figure 1 </b>Example</span><br><span><img id="apm_07_0015__en-us_topic_0000001261891441_image19695125933013" src="en-us_image_0000001675969617.png" title="Click to enlarge" class="imgResize"></span></div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="apm_07_0011.html">Application Monitoring Configuration</a></div>
</div>
</div>
<script language="JavaScript">
<!--
image_size('.imgResize');
var msg_imageMax = "view original image";
var msg_imageClose = "close";
//--></script>