
# 配置url监控项
在"编辑【URL监控】监控配置"页面根据以下示例配置。
#### 使用限制
由于Header、Url参数、Cookie等处可能存在敏感数据，配置后系统将自动拦截，请注意隐私保护。
| 参数名称           | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 样例                                  |
|:---|:---|:---|
| 采集间隔           | 采集监控项的间隔时间，支持设置15s、60s，默认60s。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 60s                                 |
| 拦截header指定key值 | 根据该配置采集header中的值，在调用链的参数中展示。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Host                                |
| 拦截url参数指定key值  | 根据该配置采集url中的值，在调用链的参数中展示。如http://127.0.0.1/test?param=123，配置成param后，调用链的参数中会展示对应的值123。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | param                               |
| 拦截cookie指定key值 | 根据该配置采集cookie中的值，在调用链的参数中展示。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | testKey                             |
| url采集配置        | 该配置可以将url包含的参数按照配置进行汇聚，如/rest/v1/test/123、/rest/v1/test/234可以汇聚成/rest/v1/test/{id}。配置方式与[httpclient的url规整配置](https://support.huaweicloud.com/usermanual-apm2/apm_07_0014.html#apm_07_0014__section195174419328)相同。 来源：user（用户），automatic（自动生成）。如果来源为automatic，规整方式仅为regex。 状态：active，inactive。当状态inactive时，本条url采集配置不生效。                                                                                                                                                                                                                                                                                 | [图1] |
| 采集黑名单配置        | 根据配置屏蔽符合条件的url数据采集。配置方式与[httpclient的url规整配置](https://support.huaweicloud.com/usermanual-apm2/apm_07_0014.html#apm_07_0014__section195174419328)相同。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | [图1] |
| 业务code采集长度限制   | 配置解析responseBody的长度限制，防止影响性能。大于该长度的body不解析，默认业务状态码是正确的。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | -                                   |
| 解析业务code的key   | 配置业务状态码的字段名称。如果接口返回内容为{"errorCode":500,"errorMsg":"error msg"} 则该字段配置为errorCode。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | errorCode                           |
| 业务code的正确值     | 配置业务状态码的正确值。所有非正确的值都会将调用链设置为错误。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | -                                   |
| 慢请求阈值定义        | 全局请求响应时间阈值，默认值为800，超过800ms以上的请求定义为慢请求，调用链的采样会提高慢请求的采样率。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | -                                   |
| url配置          | 单独定义url的响应时间阈值，该url超过指定阈值后，该url调用链数据的采样率会提高。如果未配置该参数，默认以慢请求阈值定义的配置为准。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | [图2] |
| 错误状态码定义        | 可选值：状态码400以上统计为错误、为状态码500以上统计为错误。默认值为状态码500以上统计为错误。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | -                                   |
| Url自动规整        | 例如：调用Url3次， /get/xxx/a /get/xxx/b /get/xxx/b - 选择"是"，使用Url自动规整 。 规整后： /get/xxx/a 1 /get/xxx/b 2   - 选择"否"，不使用Url自动规整。 /get/xxx/{p} 3   - 使用默认值：优先使用继承的标签值。   | -                                   |
| url最大采集行数      | Agent可以采集的url最大行数。如果Agent采集的url行数超过配置的"url最大采集行数"，那么Agent立即停止采集。默认值：500，可配置范围：10\~2000。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 500                                 |
   
图1配置样例   
![](https://support.huaweicloud.com/usermanual-apm2/zh-cn_image_0000002549815803.png "点击放大")
图2URL配置   
![](https://support.huaweicloud.com/usermanual-apm2/zh-cn_image_0000002549815805.png "点击放大")
