文档

接口详情

更新时间:

在接口详情页面,主要展示该应用所有接口的通过QPS、限流QPS、异常QPS指标、RT、并发数据等,还可以在此页面为接口管理流控规则。本文介绍接口详情页的主要功能。

功能入口

  1. 登录AHAS控制台,然后在页面左上角选择地域。
  2. 在控制台左侧导航栏中选择流量防护 > 应用防护
  3. 应用防护页面的应用卡片页签单击目标应用卡片。
  4. 在左侧导航栏选择接口详情

功能介绍

接口详情页面展示了该应用的所有接口的详细信息,包括统计的QPS、RT、并发等数据。

接口详情

您还可以在此页面进行以下操作:

  • (图标①)在页面右上角选择展示模式,默认详情展示
    • 详情展示:以时序图和时序列表的形式展现接口的通过QPS、限流QPS、RT等信息。
    • 统计展示:以列表的形式展现某一天接口的指标占比、通过总请求数、拒绝总请求数等信息。
  • (图标②)在页面右上角可以选择回放时间,查看接口的历史数据。
    说明 最多保留7天的历史数据。
  • (图标③)在顶部菜单栏中单击各类型的页签可以过滤对应类型的接口,包括WEBRPC等。
  • (图标④)在接口列表区域,单击接口名称,可以具体查看该接口QPS数据时序图、RT数据时序图、并发数据时序图以及防护事件等,以及该接口在不同节点上的流量情况。
  • (图标⑤)在时序图区域,可以选择要展示或隐藏的指标,还可以选择接口指标的展现形式。
    • 节点对比:各接口以卡片的形式展现各接口的数据。
    • 集群统计:以QPS、RT、并发各数据的统计维度展现接口的数据。

    单击右上角的下载报告图标,可以导出接口详情的数据,包括某一时间段某些接口秒级的QPS数据、RT数据等。一次最多可导出5个接口的数据,也可以选择导出PDF格式或者CSV格式。

    说明 模式的切换仅在全部接口场景下支持。
  • (图标⑥)在时序图区域,还可以对各接口设置流控规则等操作。
    • 单击添加至大盘.png图标,可以将该接口添加至流量大盘,便于在流量大盘中观测系统整体流量,具体操作,请参见创建流量大盘
    • 单击管理规则新增图标,进入管理规则新增规则对话框,可以新增或删除流控、隔离和降级规则,也可以编辑已有的规则或开启关闭规则。具体操作,请参见配置流控规则配置隔离规则配置熔断规则
    • 单击历史记录图标,可以查看该接口指标的历史数据。
      说明 最多保留7天的历史数据。
    • 单击下载报告图标,可以导出该接口详情的数据,包括某一时间段秒级的QPS数据、RT数据等,也可以选择导出PDF格式或者CSV格式。
    • 单击接口名称后,会在右侧接口概览页展示该接口对应的各数据时序图。
      • 单击节点详情页签,筛选查看不同接口的数据。
      • 单击状态统计页签,展示该接口的HTTP状态码、错误数状态码时序图等。
        说明 错误码默认为非2xx和3xx的状态码。
      • 单击异常统计页签,查看该应用近5分钟的异常情况。
        • 单击异常统计数据柱形图中的柱形,则在右侧异常TOP列表中,展示该异常的具体接口、类型、次数。
        • 单击异常统计数据右上角的历史数据,可以查看任意时间段发生的异常次数,最多可以查看7天内的历史数据。
        • 您在异常统计数据区域查看到异常数据后,可在应用本地日志中查看异常记录。
          说明 控制台查看以秒为单位的异常统计情况,异常详细内容您可以在本地异常记录文件中查看。
          • 异常记录的文件地址:与metrics.log同个目录。
          • 异常记录的文件名称:
            • {appName}-ahas_exceptions.log.{日期,精确到天}
            • {appName}-ahas_exceptions.log.{日期,精确到天}.idx
          • 异常记录格式:{时间戳}|{时间,精确到毫秒}|{异常接口}|{异常详情}

          样例如下所示:

          1619749703000|2021-04-30 10:28:23.062|/exception1|com.alibaba.csp.sentinel.demo.exception.TestException: test exception_1 15
          1619749703000|2021-04-30 10:28:23.065|/exception|com.alibaba.csp.sentinel.demo.exception.AnotherException: test another exception 71
          1619749705000|2021-04-30 10:28:25.065|/exception1|com.alibaba.csp.sentinel.demo.exception.TestException: test exception_1 38

导出接口数据

AHAS可以导出各个接口详情的数据,包括某一时间段接口秒级的QPS数据、RT数据等,便于您统计分析数据。

  1. 登录AHAS控制台,然后在页面左上角选择地域。
  2. 在控制台左侧导航栏中选择流量防护 > 应用防护
  3. 应用防护页面的应用卡片页签单击目标应用卡片。
  4. 在左侧导航栏选择接口详情
  5. 您可以通过以下任意一种方式导出数据。
    • 接口详情页时序图区域的右上角单击下载报告图标,可以导出多个接口的数据。
    • 接口列表区域,单击接口名称,在时序图区域的右上角单击下载报告图标,可以导出该接口的数据。
  6. 导出接口详情数据对话框中,选择时间、导出接口以及导出类型,单击确定
    导出接口数据.png
    说明 目前支持一次性最多导出5个接口的数据。