跳到主要内容
版本:3.7.0

远程接口识别

远程接口指请求端采集的远程调用地址按规则识别的接口,并非传统服务通过探针识别的接口。通过配置HTTP协议远程接口自定义规则、自定义远程调用、请求属性,可实现远程接口的精细化识别与管理。

HTTP协议远程接口自定义规则

用于自定义 HTTP 协议下远程接口的识别逻辑,支持通过 IP/域名、URL 及参数等维度配置规则。

创建 HTTP 协议远程接口自定义规则

点击HTTP协议远程接口自定义规则区域的创建按钮,按以下步骤进行配置:

1760152531880

生效范围:选择「IP/域名:端口」作为生效维度,支持 手动添加「批量选择」「批量删除」目标 IP/域名与端口,规则仅对选定范围的远程接口生效。

URL 及参数识别:配置 URL 路径的匹配规则:

  • 选择匹配维度(如URL路径)、匹配方式(如前缀);
  • 输入路径值(示例:/api/remote),用于识别特定路径的远程接口。

URL 内容匹配设置:支持以星号 * 替代 URL 路径中符合条件的段,可开启以下开关并配置阈值:

  • 以星号*替代URL路径段中全部为数字的段:开启后,纯数字的路径段会被星号替代,统一识别逻辑。
  • 以星号*替代URL路径段中超过N个字符的段:输入阈值(如 30),超过该长度的路径段会被星号替代。
  • 以星号*替代URL路径段中数字超过N个字符的段:输入阈值(如 3),数字长度超过该值的路径段会被星号替代。

描述:输入规则描述(如“识别订单服务 HTTP 远程接口”),便于后续管理。

自定义远程调用

此功能会对匹配规则的类重新转码。

提示

转码可能引起线程短暂停止,影响接口执行耗时;且会被监控采集,增加执行时间。非必要请勿频繁修改配置,建议业务低峰期操作

创建自定义远程调用识别规则

点击自定义远程调用区域创建按钮,按以下步骤进行配置:

1760152554458

生效范围:选择服务作为生效维度,匹配方式选精确匹配,并从下拉框选择具体服务(规则仅对选定服务的远程调用生效)。

匹配规则:配置类与方法的匹配条件:

  • 匹配类:选择维度(如类名)、匹配方式(如等于),输入目标类名;
  • 匹配方法:选择维度(如方法名称)、匹配方式(如等于),输入目标方法名。

远程调用命名(仅 Java 类型服务生效):可组合勾选命名规则:

  • 在远程调用名称中使用自定义名称:手动输入自定义名称;
  • 在远程调用名称中使用类名:选择简单类名或完整类名;
  • 在远程调用名称中使用方法名:将方法名纳入远程调用名称;
  • 在远程调用名称中使用请求属性:关联请求属性到远程调用命名。

远程接口命名(仅 Java 类型服务生效):远程接口名称默认使用方法名,可选在远程接口名称中使用请求属性,将请求属性归属到同一远程接口下。

描述:输入规则用途说明(如“自定义订单服务远程调用识别”)。

请求属性

此功能会对匹配规则的类重新转码(影响说明同「自定义远程调用」,需谨慎操作),用于定义远程接口的请求属性识别规则。

创建请求属性

1760152596001

点击请求属性区域的创建按钮,配置属性名称等信息,用于后续远程接口识别时关联请求属性。