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

配置自定义状态码

根据HTTP响应码及调用是否异常,判断节点的调用状态。有时调用的状态是在header或body中定义的,底层异常会被捕获并返回值为200的HTTP响应码。本功能允许用户自定义状态码解析方式,包括状态码在响应体中的字段名和可能的正确取值,以便能正确识别出异常调用。

前提条件

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

配置自定义状态码

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

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

  1. 选择“自定义状态码”页签。
  2. 单击“新增”,在弹出的窗口中配置自定义状态码,参数说明如表1所示。

    表1 自定义状态码参数说明

    参数名称

    参数说明

    规则名称

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

    匹配接口

    配置匹配接口。

    是否生效

    开启后,规则生效。

    状态码来源

    • header
    • body

    请求结果判断依据

    状态码来源为header时,配置此参数。

    • 状态码
    • 成功标记

    状态码参数名

    填入响应体Json字符串中状态码字段名,如果有多级,通过“.”分隔。因此在演示Demo中,应配置为ret.code。

    成功状态码列表

    表示请求成功时状态码可以取的值,多个值通过英文逗号分隔。

    成功标记参数名

    状态码来源为header,请求结果判断依据为成功标记时,配置此参数。

    成功标记的成功值

    状态码来源为header,请求结果判断依据为成功标记时,配置此参数。

  3. 单击“确定”

相关文档