文档首页/ 应用性能管理 APM/ API参考(2.0)/ API/ APP监控/ App监控查询时间维度卡顿折线图 - ShowRumAppViewTrend
更新时间:2026-11-20 GMT+08:00
分享

App监控查询时间维度卡顿折线图 - ShowRumAppViewTrend

功能介绍

查询APP监控按时间维度统计的卡顿次数折线图。

调用方法

请参见如何调用API。

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    apm:application:getService

    Read

    -

    -

    apm:apm2Service:get

    -

URI

POST /v2/rum-app/view/get-app-trend/{app_id}

表1 路径参数

参数

是否必选

参数类型

描述

app_id

是

String

参数解释:

App应用ID。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

从IAM服务获取的用户Token。获取方式请参见:获取Token。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

start_timestamp

是

String

参数解释:

查询开始时间,毫秒时间戳。

约束限制:

开始时间和结束时间必须同时设置。

取值范围:

毫秒级时间戳字符串。

默认取值:

不涉及。

end_timestamp

是

String

参数解释:

查询结束时间,毫秒时间戳。

约束限制:

开始时间和结束时间必须同时设置。

取值范围:

毫秒级时间戳字符串。

默认取值:

不涉及。

timestamp

否

Long

参数解释:

上报时间戳。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

url

否

String

参数解释:

页面URL。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

uuid

否

String

参数解释:

会话唯一标识。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

custom_key

否

String

参数解释:

自定义维度键。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

str_val

否

String

参数解释:

自定义维度值。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

type

否

String

参数解释:

查询类型。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

ssid

否

String

参数解释:

会话标识。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

name

否

String

参数解释:

名称。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

function_type

否

String

参数解释:

查询的功能类型。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

search_list

否

Array of Map<String,String> objects

参数解释:

搜索条件列表。

约束限制:

不涉及。

device_id

否

String

参数解释:

设备ID。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

t

是

String

参数解释:

功能类型,取值决定查询的数据类型。

约束限制:

必填。

取值范围:

  • anr-version:ANR版本维度。

  • anr-device:ANR设备维度。

  • loopAnr-version:循环ANR版本维度。

  • loopAnr-device:循环ANR设备维度。

  • crash-version:崩溃版本维度。

  • crash-device:崩溃设备维度。

  • error-device:错误设备维度。

  • error-version:错误版本维度。

  • anr-time:ANR时间维度。

  • anr-overview:ANR总览。

  • crash-time:崩溃时间维度。

  • loopAnr-time:循环ANR时间维度。

  • crash-overview:崩溃总览。

  • custom-event:自定义事件。

  • device-overview:设备总览。

  • error-time:错误时间维度。

  • error-overview:错误总览。

  • network-rate:网络速率。

  • network-overview:网络总览。

  • network-time:网络时间维度。

  • launch-overview:启动总览。

  • launch:启动。

默认取值:

不涉及。

state

否

String

参数解释:

状态筛选条件。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

tags

否

String

参数解释:

标签筛选条件。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

range_min

否

Long

参数解释:

取值范围最小值。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

range_max

否

Long

参数解释:

取值范围最大值。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

status

String

参数解释:

操作结果状态,成功时返回“success”。

取值范围:

不涉及。

rum_instances

RumTrendResponse object

参数解释:

时间维度趋势数据。

表5 RumTrendResponse

参数

参数类型

描述

trend_keys

Array of strings

参数解释:

趋势维度键列表。

trend_values

Array of objects

参数解释:

趋势值列表。

trend_times

Array of longs

参数解释:

趋势时间点列表(毫秒时间戳)。

trend_lines

Array<Array<String>>

参数解释:

趋势线条数据列表。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

状态码:403

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

请求示例

/v2/rum-app/view/get-app-trend/app-xxxxxx

{
  "start_timestamp" : "1783651200000",
  "end_timestamp" : "1783737599000",
  "t" : "device-overview"
}

响应示例

状态码:200

{
  "rum_instances" : {
    "trend_keys" : [ "launch_avg_t0" ],
    "trend_values" : [ 4872 ],
    "trend_times" : [ 1792891620000, 1792891680000, 1792891740000, 1792891800000, 1792891860000 ],
    "trend_lines" : [ [ 0 ], [ 0 ], [ 0 ], [ 0 ], [ 0 ] ]
  },
  "status" : "success"
}

状态码:400

"\"\\\"\\\\\\\"{\\\\\\\\n  \\\\\\\\\\\\\\\"error_code\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\"apm2.00000005\\\\\\\\\\\\\\\",\\\\\\\\n  \\\\\\\\\\\\\\\"error_msg\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\"invalid parameter\\\\\\\\\\\\\\\"\\\\\\\\n}\\\\\\\"\\\"\""

状态码:403

"\"\\\"\\\\\\\"{\\\\\\\\n  \\\\\\\\\\\\\\\"error_code\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\"apm2.00000004\\\\\\\\\\\\\\\",\\\\\\\\n  \\\\\\\\\\\\\\\"error_msg\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\"has no privilege\\\\\\\\\\\\\\\"\\\\\\\\n}\\\\\\\"\\\"\""

状态码

状态码

描述

200

查询时间维度折线图成功。

400

非法请求,建议根据error_msg检查修改该请求。

403

请求被拒绝访问。

错误码

请参见错误码。

相关文档