服务端请求参数
定义请求参数以使用元数据丰富受监视的请求,您可以在调用链详情中查看属性键值对、也可针对属性过滤。
提示
此功能会对匹配规则的类进行重新转码,转码可能引起线程短暂停止,进而影响接口执行耗时;且该方法会被监控采集,执行时间将略微增加;故非必要请勿频繁改动配置(创建/启用/禁用/编辑/删除),如必须操作建议在业务低谷时间段进行配置。
如何配置请求参数
- 进入部署配置->规则配置->数据采集->服务端请求参数页面

- 点击创建进入创建页面

- 请求属性:标识当前请求属性的唯一名称,用于后续识别与管理。
- 数据类型:指定请求属性的 数据类型 ,初始设置后不允许修改。分位文本、整型和浮点型。
- 多值处理:当一个请求返回多个值时,指定该属性应保留哪些值(每次请求,每个属性最多存储 10 个值)。
- 大小写:设置属性值的 大小写处理规则 。
- 点击添加数据源,会弹出配置窗口

- 数据源名称:标识当前请求属性的唯一名称,用于后续识别与管理。
- 生效范围:指定该数据源生效的服务范围
- 属性来源:选择要捕获的属性来源
- 高级设置:用于 进一步限制或处理捕获的参数 ,包含以下能力:
- JSONPath 解析 :若数据为 JSON 格式,可通过「JSONPath 表达式」解析(非 JSON 格式请跳过)。输入表达式后,可点击「预览」查看解析效果。
- 截取字符串 :配置 “起始位置” 和 “截取规则”,从原始数据中截取指定片段。
- 多属性值拆分 :输入「分隔符」,将属性值拆分为多个值(如用
,拆分“a,b,c”为[“a”,“b”,“c”])。 - 精简空白区 :勾选后,自动去除属性值中的多余空白字符(如空格、换行)。
- 条件过滤 :仅当属性值满足「条件」(如 “等于”“包含”)和「目标值」时,才使用该返回值。
- 正则表达式提取 :输入正则表达式,从捕获的原始数据中提取目标值。
- 保存:配置完成后,点击保存按钮,完成创建。