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

获取链路追踪原始数据表格(V2) - ShowSkywalkingMetricRawTable

功能介绍

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

调用方法

请参见如何调用API

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    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

OK

{
  "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
}

状态码

状态码

描述

200

OK。

400

Bad Request。

403

Forbidden。

429

Too Many Requests。

错误码

请参见错误码

相关文档