文档首页/ 应用性能管理 APM/ API参考(2.0)/ API/ 链路追踪/ 获取链路追踪概览表格数据(V2) - ShowSkywalkingMetricOverviewAnalysisTable
更新时间:2026-03-05 GMT+08:00
分享

获取链路追踪概览表格数据(V2) - ShowSkywalkingMetricOverviewAnalysisTable

功能介绍

获取链路追踪概览表格数据。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    apm::getConf

    Read

    -

    -

    • apm:apm2BusinessView:get
    • apm:apm2Service:get

    -

URI

POST /v2/view/sw/metric/get-overview-analysis-table

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

从IAM服务获取的用户Token。

x-business-id

Long

应用id

表2 请求Body参数

参数

是否必选

参数类型

描述

env_id

Long

环境id。

key

String

指标项。

start_time

String

开始时间,毫秒级时间戳。

end_time

String

结束时间,毫秒级时间戳。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

[数组元素]

Array of SumTableResponse_OverviewAnalysisTable objects

-

表4 SumTableResponse_OverviewAnalysisTable

参数

参数类型

描述

row_list

Array of FrontRow_OverviewAnalysisTable objects

数据行列表。

latest_data_Time

Long

最近一笔数据的时间。

table_direction

String

表格的方向,H:表头横向,V:表头纵向。

枚举值:

H

V

real_start_time

Long

实际开始的时间。

real_end_time

Long

实际结束的时间。

notice_msg

String

提示信息。

total_count

Integer

总数。

表5 FrontRow_OverviewAnalysisTable

参数

参数类型

描述

header

Boolean

是否是header信息。

cell_list

FrontCell_OverviewAnalysisTable object

数据单元集合。

filter

String

将group by的字段拼接成过滤字符串。

表6 FrontCell_OverviewAnalysisTable

参数

参数类型

描述

trace

Boolean

是否调用链。

data_type

String

数据类型。

function

String

函数。

text

String

文本信息。

visible

Boolean

是否可见。

请求示例

/v2/view/sw/metric/get-overview-analysis-table

{
  "env_id" : "1628824",
  "start_time" : 1767668581861,
  "end_time" : 1767754981861,
  "key" : "$collectorCategory.swSlowInvoking$"
}

响应示例

状态码:200

OK

{
  "row_list" : [ {
    "header" : true,
    "cell_list" : [ {
      "trace" : false,
      "data_type" : "ENUM",
      "function" : "",
      "text" : "url",
      "visible" : true
    }, {
      "data_type" : "INT",
      "function" : "MAX(maxTime) as=最大耗时(ms) isTrace=false",
      "text" : "最大耗时(ms)",
      "visible" : true
    }, {
      "data_type" : "DOUBLE",
      "function" : "SUM(totalTime)/SUM(invokeCount) as=平均耗时(ms) isTrace=false",
      "text" : "平均耗时(ms)",
      "visible" : true
    }, {
      "data_type" : "INT",
      "function" : "SUM(slowCount) as=慢调用次数 isTrace=false",
      "text" : "慢调用次数",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "POST /user/login",
      "visible" : true
    }, {
      "text" : "133394",
      "visible" : true
    }, {
      "text" : "131362.16",
      "visible" : true
    }, {
      "text" : "1392",
      "visible" : true
    } ],
    "filter" : "url=POST /user/login"
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "POST /user/validate",
      "visible" : true
    }, {
      "text" : "132455",
      "visible" : true
    }, {
      "text" : "130361.11",
      "visible" : true
    }, {
      "text" : "1719",
      "visible" : true
    } ],
    "filter" : "url=POST /user/validate"
  } ],
  "latest_data_Time" : 0,
  "table_direction" : "H",
  "real_start_time" : 1767682331634,
  "real_end_time" : 1767768731634,
  "total_count" : 2
}

状态码

状态码

描述

200

OK。

400

Bad Request。

403

Forbidden。

429

Too Many Requests。

错误码

请参见错误码

相关文档