应用性能监控提供了从调用链路中提取特定属性的能力,无侵入地提取请求和响应中的指定参数。您可以配置业务参数提取规则,并根据提取出的参数配置自定义错误。
前提条件
该功能目前仅支持Java应用。
只支持安装1.10.0或以上版本探针,具体操作,请参见应用监控接入概述。如果您的探针版本低于1.10.0,本功能配置后将不会有任何作用和影响。
功能入口
登录应用性能监控控制台,在左侧导航栏选择应用监控 > 应用列表。
选择对应的应用。
在上方导航栏选择应用配置,选择后,点击左侧业务参数提取规则。
在业务参数提取规则区域,您可以创建、查看和修改当前应用的业务参数提取规则。
APM的 JavaAgent 会动态识别规则变化,并依照所有已启动的规则将业务参数提取出来。
业务参数提取规则
新增规则
在业务参数提取规则区域单击新增规则,填写规则信息并保存。
规则名称:该条规则的可读名称。
Attribute名称:该条规则提取出的值在Span中对应的Attribute名称,默认以biz.开头,后续由多个单词组成,每个单词仅允许由大小写字母、数字、短划线(-)、下划线(_)组成。
参数提取类型:需要提取的参数类型。
生效接口(HTTP类型):该条规则作用的HTTP接口范围,探针仅对匹配成功的接口提取相应参数。
参数提取规则:定义待提取参数所在的实际载体来源和提取后的处理方式,支持配置多个参数来源和提取步骤。若多个来源均可提取到参数,排序在前的参数提取步骤优先级高于后者.
参数来源:待提取参数所在的实际载体来源,对于Header、Cookie、Parameter,需要您填写相应的Key来初步提取。
是否启用:该条规则是否启用。
生效验证
参数提取规则配置完成后,无需重启应用即可生效。跳转到调用链分析页面查看相关调用链,如果对应接口的Span Attribute有自定义的Attribute被写入,说明提取规则生效。
找到新增的规则对应的Attribute名称。
在调用链分析页面添加biz.$attributesName作为查询条件,过滤相关Span
单击任意一条Trace,在对应的Span下可以看到自定义的Attributes。
管理规则
启用/禁用规则:在目标规则右侧设置是否启用开关。
编辑和删除:在目标规则右侧单击编辑和删除,可以修改或删除对应规则。