URL采集设置
更新时间 2025-11-11 11:11:21
最近更新时间: 2025-11-11 11:11:21
支持URL采集相关的自定义配置。
功能入口
选择目标资源池，并登录APM组件控制台。
在左侧导航栏中选择「应用监控」-「应用列表」。
在应用列表中选择您想查看的应用，点击「应用名称」打开新的应用详情链接。
在左侧导航栏中选择「应用设置」-「URL采集设置」。
功能说明
| 功能板块 | 说明 |
| URL拦截设置 |
用于设置展示包含指定header/url参数的url |
| 慢请求响应阈值设置 | 用于设置单个url及全局的慢请求响应阈值 |
| Code定义 | 用于设置业务code采集长度以及定义状态码的正确/错误值 |
| 其他采集设置 | 用于设置url黑名单 |
URL拦截设置
用于设置拦截header/url参数。
| 参数名称 | 说明 | 样例 |
| 拦截header指定key值 | 根据该配置采集header中的值，在调用链的参数中展示。 | Host |
| 拦截url参数指定key值 | 根据该配置采集url中的值，在调用链的参数中展示。如http://127.0.0.1/test?apm=123，配置成apm后，调用链的参数中会展示对应的值123。 | apm |
注意：header、url参数可能涉及敏感数据，系统会根据您的配置自动拦截，请注意隐私保护。
慢请求响应阈值设置
公共阈值
默认500ms。当接口响应时间大于该阈值的时候，该接口会被标记为慢调用，监控概览中的慢调用数据会随着配置改变。
单个url阈值
正常调用下采样率判断优先级如下：
公共采样率（命中采）<局部采样率（若没有可忽略，命中采）<慢请求响应公共阈值（命中采）<单个url慢请求阈值（命中采）<黑名单（命中不采）
| 参数名称 | 说明 | 样例 |
| 慢请求响应公共阈值 | 用于定义全局慢请求阈值。
| 500 |
| 慢请求响应单个url阈值 | 用于定义某个url的慢请求阈值。
|
500 |
Code定义
自定义错误状态码，影响错误数展示。
业务code采集长度限制
自定义code采集长度，避免影响性能。
业务code解析
用于定义状态码的正确值。
如果设置多个业务code，那么只有所有业务code的值都满足正确值时，该url的业务code解析才会被判定为正确。
错误状态码定义
用于定义错误状态码。
错误调用下采集优先级判断如下：
业务code自定义（非正确采）<错误状态码定义（命中采）
| 参数名称 | 说明 | 样例 |
| 业务code采集长度限制 | 配置解析responseBody的长度限制，大于该长度的body不解析，防止影响性能。
0～2,000间的任意整数。 | 50 |
| 解析业务code的key | 配置业务状态码的字段名称。
| errorCode |
| 业务code的正确值 | 配置业务状态码的正确值。
| 200,202 |
| 错误状态码定义 | 配置业务状态码的错误值范围。
| - |
其他采集设置
当前支持设置采集黑名单，提供四种匹配方式。
黑名单
符合匹配规格的url将不予采集。
| 匹配方式 | 说明 | 匹配表达式示例 | 实现效果 |
| startwith | 匹配表达式开头的url，并进行屏蔽。 | http://127.0.0.1/apm1 | 以http://127.0.0.1/apm1开头的url均被屏蔽 |
| endwith | 匹配表达式结尾的url，并进行屏蔽。 | /apm | 以/apm结尾的url均被屏蔽 |
| include | 包含匹配表达式的url，会被屏蔽。 | apm | 包含apm的url均被屏蔽 |
| regex | 符合通配符表达式的url，会被屏蔽。 | /apm/t?st （?可匹配任意一个字符） | 包含/apm/test和/apm/tEst的url均被屏蔽，但包含/apm/tst不会被屏蔽 |
/apm/*.x （*可匹配零个、一个、多个字符） | 包含apm目录下所有.x结尾的url均被屏蔽 | ||
/**/apm （**可匹配零个、一个、多个目录） | 包含/app/test，/app/foo/test 和 /test的url均被屏蔽 |
