获取链路追踪原始数据表格（V2） - ShowSkywalkingMetricRawTable

功能介绍

获取链路追踪原始数据表格。

调用方法

请参见如何调用API。

授权信息

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

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

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项
apm::getConf

Read

-

-

apm:apm2BusinessView:get

apm:apm2Service:get

-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
apm::getConf	Read	-	-	apm:apm2BusinessView:get apm:apm2Service:get	-

URI

POST /v2/view/sw/metric/raw-table

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	从IAM服务获取的用户Token。
x-business-id	是	Long	应用id。

表2 请求Body参数
参数	是否必选	参数类型	描述
lastRowId	否	String	上一次扫描的数据ID。
instance_id	否	Long	实例id。
monitor_item_id	否	Long	监控项id。
env_id	是	Long	环境id。
start_time	是	String	开始时间。
end_time	是	String	结束时间。
page	是	Integer	当前页码。
page_size	是	Integer	每页数据总数。
order_by	否	String	排序。
search_word	否	String	搜索关键字。
view_config	是	RawTableView object	原始数据表格视图。

表3 RawTableView
参数	是否必选	参数类型	描述
span	是	Boolean	跨度。
latest	否	Boolean	是否只展示最近一笔数据。
collector_name	是	String	采集器名称。
metric_set	是	String	视图对应的指标集的名称。
title	是	String	图标所需展示的标题。
table_direction	是	String	表格的方向，H：默认，表头横向，V：表头纵向。枚举值： H V
group_by	是	String	分组规则。
filter	是	String	过滤列表模型。
field_item_list	是	Array of FieldItem objects	所需展示的字段列表模型集合。
span_field	是	String	跨度字段。
order_by	否	String	排序规则。
view_type	否	String	视图类型。枚举值： trend sumtable rawtable

表4 FieldItem
参数	是否必选	参数类型	描述
trace	否	Boolean	是否是trace。
function	是	String	表达式。
as	否	String	名称。
default_value	否	String	默认值。
precision	否	Integer	百分比。
unit	否	String	单位。
visible	否	Boolean	是否可见。

响应参数

状态码：200

表5 响应Body参数
参数	参数类型	描述
row_list	Array of FrontRow_MetricRawTable objects	数据行。
latest_data_Time	String	最近一笔数据的时间。
table_direction	String	表格的方向，H：默认，表头横向，V：表头纵向。枚举值： H V
result_id	String	上次请求id。
real_start_time	Long	实际开始的时间，主要用于下一次调用，特别是分页调用的时候传的参数。
real_end_time	Long	实际结束的时间。

表6 FrontRow_MetricRawTable
参数	参数类型	描述
header	Boolean	是否是header信息。
cell_list	Array of FrontCell_MetricRawTable objects	数据单元集合。

表7 FrontCell_MetricRawTable
参数	参数类型	描述
data_type	String	数据类型。
text	String	文本信息。
visible	Boolean	是否可见。

请求示例

/v2/view/sw/metric/raw-table

{
    "end_time": 1767693439207,
    "env_id": "1628821",
    "page": 1,
    "page_size": 10,
    "start_time": 1767607039207,
    "view_config": {
        "span": true,
        "collector_name": "swRpcClient",
        "metric_set": "swRpcServer.url",
…}

响应示例

状态码：200

{
  "row_list" : [ {
    "header" : true,
    "cell_list" : [ {
      "data_type" : "STRING",
      "text" : "time",
      "visible" : true
    }, {
      "data_type" : "STRING",
      "text" : "慢调用链",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:57:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104338.17676934251230149",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:56:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.99630.17676933758288639",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:55:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104188.17676933224000749",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:54:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.87790.17676932757205043",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:53:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104249.17676932227420495",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:52:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.98012.17676931757535135",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:51:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.98012.17676930755035133",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:50:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104249.17676930220680491",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:49:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104188.17676929753950743",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:48:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104339.17676929223060133",
      "visible" : true
    } ]
  } ],
  "latest_data_Time" : "2026-01-06 17:57:19",
  "table_direction" : "H",
  "real_start_time" : 1767607039207,
  "real_end_time" : 1767693439207
}