# 查询链路追踪指标趋势图（V2） - ShowSkywalkingMetricTrend #### 功能介绍 查询链路追踪趋势图。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-apm/apm_04_0007.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-apm/apm_04_0021.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | apm::getConf | Read | - | - | - apm:apm2BusinessView:get - apm:apm2Service:get | - | #### URI POST /v2/view/sw/metric/trend #### 请求参数 表1请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 从IAM服务获取的用户Token。 | | x-business-id | 是 | Long | 应用id。 | 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | instance_id | 否 | Long | 实例id。 | | monitor_item_id | 否 | Long | 监控项id。 | | env_id | 是 | Long | 环境id。 | | start_time | 是 | String | 开始时间，毫秒级时间戳。 | | end_time | 是 | String | 结束时间，毫秒级时间戳。 | | view_config | 是 | [TrendView] object | 视图配置信息。 | 表3TrendView | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | span字段属性。 | | view_type | 否 | String | 视图类型。 | 表4FieldItem | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | trace | 否 | Boolean | 是否是trace。 | | function | 是 | String | 表达式。 | | as | 否 | String | 名称。 | | default_value | 否 | String | 默认值。 | | precision | 否 | Integer | 百分比。 | | unit | 否 | String | 单位。 | | visible | 否 | Boolean | 是否可见。 | #### 响应参数 **状态码：200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | line_list | Array of [FrontLine] objects | 数据行列表。 | | latest_data_Time | Long | 最近一笔数据的时间。 | 表6FrontLine | 参数 | 参数类型 | 描述 | |:---|:---|:---| | point_list | Array of [FrontPoint] objects | 数据点集合。 | | title | String | 标题。 | | unit | String | 单位。 | | precision | Integer | 百分比。 | | data_type | String | 日期类型。 | | visible | Boolean | 是否可见。 | 表7FrontPoint | 参数 | 参数类型 | 描述 | |:---|:---|:---| | time | Long | 时间。 | | value | Object | 值。 | #### 请求示例 ``` /v2/view/sw/metric/trend { "end_time": 1767776243423, "env_id": "1628822", "start_time": 1767775943423, "view_config": { "collector_name": "swRpcClient", "metric_set": "swRpcServer.total", "title": "服务端概览", "filter": "", "field_item_list": [ ], "view_type": "trend" } } ``` #### 响应示例 **状态码：200** OK ``` { "line_list" : [ { "point_list" : [ { "time" : 1767775920000 }, { "time" : 1767775980000, "value" : 8 }, { "time" : 1767776040000, "value" : 2 }, { "time" : 1767776100000 }, { "time" : 1767776160000 }, { "time" : 1767776220000 } ], "title" : "调用次数", "data_type" : "INT", "visible" : true }, { "point_list" : [ { "time" : 1767775920000 }, { "time" : 1767775980000, "value" : 129873.625 }, { "time" : 1767776040000, "value" : 130331 }, { "time" : 1767776100000 }, { "time" : 1767776160000 }, { "time" : 1767776220000 } ], "title" : "平均耗时(ms)", "data_type" : "DOUBLE", "visible" : true }, { "point_list" : [ { "time" : 1767775920000 }, { "time" : 1767775980000, "value" : 132267 }, { "time" : 1767776040000, "value" : 131713 }, { "time" : 1767776100000 }, { "time" : 1767776160000 }, { "time" : 1767776220000 } ], "title" : "最大耗时(ms)", "data_type" : "INT", "visible" : true }, { "point_list" : [ { "time" : 1767775920000 }, { "time" : 1767775980000, "value" : 8 }, { "time" : 1767776040000, "value" : 2 }, { "time" : 1767776100000 }, { "time" : 1767776160000 }, { "time" : 1767776220000 } ], "title" : "错误次数", "data_type" : "INT", "visible" : true } ], "latest_data_Time" : 0 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK。 | | 400 | Bad Request。 | | 403 | Forbidden。 | | 429 | Too Many Requests。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-apm/ErrorCode.html)。