更新时间:2025-06-27 GMT+08:00
分享

配置调用链采样白名单

智能采样策略下,调用链会采样上报,其策略和采样流量由调用链首节点配置决定。如果用户希望符合某些条件的调用链都能上报,这一功能称为采样白名单。 采样白名单的配置可以作用在调用链的中间节点。

如果首节点因限流计划不采集,但中间节点又符合采样白名单的条件,则全链路可能会上报不完整。一般检测到需要采集时,会尽最大可能将能感知这一变化的节点上报上去。 智能采样下,调用链的采样及限流关系如图1所示。

图1 调用链的采样及限流关系

前提条件

已获取服务运维岗位权限或运维管理员权限,权限申请操作请参见申请权限

配置调用链采样白名单

  1. 进入AppStage运维中心
  2. 在顶部导航栏选择服务。
  3. 单击,选择运维 > 调用链服务(NUWA Trace)
  1. 在左侧导航栏选择配置管理 > 采集管理
  2. 在采集管理页面,选择左侧树某一级别的树节点,即在该级别设置配置值。

    支持按服务、微服务、集群、节点IP等4级配置。如果某一级未进行设置,则值与上一级的配置保持一致。如果所有级别都未设置配置值,则取默认值。

  1. 选择“调用链采样白名单”页签。
  2. 单击“新增”,在弹出的窗口中配置白名单参数,参数说明如表1所示。

    表1 调用链采样白名单参数说明

    参数名称

    参数说明

    规则名称

    填写规则名称。支持中文,字母,数字,横线,下划线和点,1~100个字符。

    匹配接口

    配置匹配接口。

    是否生效

    开启后,规则生效。

    参数条件

    单击新增条件,配置如下参数:

    • 参数来源:参数来源支持选择HTTP请求的query、header、cookie、body,body参数采集性能较差,请谨慎选择。
    • 参数:采集的参数名。
    • 参数值:匹配的参数值。
    • 操作:参数条件配置完成后进行保存,保存后支持编辑及删除。

    设置后,只有当采集到的参数对应的值为指定参数值时,请求才符合采样白名单规则。如果配置多个参数,则需要同时满足才会通过白名单校验规则。

  3. 单击“确定”

相关文档