跳到主要内容
版本:3.7.0

服务端请求参数

定义请求参数以使用元数据丰富受监视的请求,您可以在调用链详情中查看属性键值对、也可针对属性过滤。

提示

此功能会对匹配规则的类进行重新转码,转码可能引起线程短暂停止,进而影响接口执行耗时;且该方法会被监控采集,执行时间将略微增加;故非必要请勿频繁改动配置(创建/启用/禁用/编辑/删除),如必须操作建议在业务低谷时间段进行配置。

如何配置请求参数

  1. 进入部署配置->规则配置->数据采集->服务端请求参数页面1759039548602
  2. 点击创建进入创建页面1759041300825
  • 请求属性:标识当前请求属性的唯一名称,用于后续识别与管理。
  • 数据类型:指定请求属性的 数据类型初始设置后不允许修改。分位文本、整型和浮点型。
  • 多值处理:当一个请求返回多个值时,指定该属性应保留哪些值(每次请求,每个属性最多存储 10 个值)。
  • 大小写:设置属性值的 大小写处理规则
  1. 点击添加数据源,会弹出配置窗口1759058018473
  • 数据源名称:标识当前请求属性的唯一名称,用于后续识别与管理。
  • 生效范围:指定该数据源生效的服务范围
  • 属性来源:选择要捕获的属性来源
  • 高级设置:用于 进一步限制或处理捕获的参数 ,包含以下能力:
    • JSONPath 解析 :若数据为 JSON 格式,可通过「JSONPath 表达式」解析(非 JSON 格式请跳过)。输入表达式后,可点击「预览」查看解析效果。
    • 截取字符串 :配置 “起始位置” 和 “截取规则”,从原始数据中截取指定片段。
    • 多属性值拆分 :输入「分隔符」,将属性值拆分为多个值(如用 , 拆分 “a,b,c”[“a”,“b”,“c”])。
    • 精简空白区 :勾选后,自动去除属性值中的多余空白字符(如空格、换行)。
    • 条件过滤 :仅当属性值满足「条件」(如 “等于”“包含”)和「目标值」时,才使用该返回值。
    • 正则表达式提取 :输入正则表达式,从捕获的原始数据中提取目标值。
  1. 保存:配置完成后,点击保存按钮,完成创建。