文档中心

应用性能监控全链路版

CPU 监控

GetAppCPUTrend

GetAppCPUTrend

获取CPU各项指标趋势。

请求说明

客户端监控已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅服务地址文档，根据业务所在地选择最合适的接入点。

请求方式：POST

请求地址：https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=GetAppCPUTrend&Version=2022-10-12

请求参数

下方仅列出该接口特有的请求参数和部分公共参数，更多详细信息参见公共参数。

参数	类型	是否必选	示例值	描述
Action	String	是	GetAppCPUTrend	接口名称。当前 API 的名称为 GetAppCPUTrend。
Version	String	是	2022-10-12	接口版本。当前 API 的版本为 2022-10-12。
start_time	Integer	否	1619827200	起始时间（Unix时间戳）。
end_time	Integer	否	1619913600	结束时间（Unix时间戳）。
filters	Object of Condition	否	-	筛选条件，可以指定多个键值对来筛选数据。
granularity	Integer	否	60	数据粒度。例如 '60' 表示分钟级粒度。
biz_type	String	否	cpu	业务类型。 cpu：CPU指标 cpu_thread：CPU异常
metric	String	否	crash_count	CPU指标，metric 与平台绑定，需按平台传： iOS： app_usage peak_usage Android： app_usage_rate app_max_usage_rate app_stat_speed app_max_stat_speed Harmony： app_usage_rate app_max_usage_rate 请求时 filters 里传 dimension=os, values=["iOS"\|"Android"\|"Harmony"] 与 metric 保持匹配。
scales	Array of String	否	["avg", "pct95", "pct95"]	统计度量。 avg：平均值 pct25：25分位值 pct50：50分位值 pct70：70分位值 pct90：90分位值 pct95：95分位值

Condition

参数	类型	是否必选	示例值	描述
op	String	否	in	操作符。 gt：大于 gte：大于等于 lt：小于 lte：小于等于 eq：等于 neq：不等于 in：包含 not_in：不包含 lk：模糊匹配特定模式的数据 nlk：排除模糊匹配的数据
type	String	否	expression	筛选条件类型。 expression：当前condition是一个表达式。 and：当前condition是一个复合表达式，多个sub_condition的逻辑关系是and。 or：当前condition是一个复合表达式，多个sub_condition的逻辑关系是or。 map：当前condition是map类型。
value	String	否	123456	筛选值。
values	Array of String	否	[123456]	筛选值，支持多个。
map_key	String	否	key_1	map类型key，当type为map时必填。
dimension	String	否	aid	条件的名称。
sub_conditions	Array of Condition	否	-	子条件。

请求示例

返回参数

参数	类型	示例值	描述
data	Object of MultiTrendResponseData	-	返回数据。
error_msg	String	-	错误信息。
error_no	Integer	0	错误码。

MultiTrendResponseData

参数	类型	示例值	描述
use_rate	JSON Map	-	用户使用率。
sample_cnt	Object of TrendLine	-	指标趋势。
sample_total	Integer	100	样本总量。
use_rate_avg	Double	0.5	平均值。

UseRate

参数	类型	示例值	描述
key	String	metric	指标key。
value	Object of TrendLine	-	样本量。

TrendLine

参数	类型	示例值	描述
name	String	test123	线的名称，在分组的情况下，name应该是分组维度的取值，比如用来显示曲线的图标。
points	Array of TrendPoint	-	曲线上的点。
total	Double	10	总数

TrendPoint

参数	类型	示例值	描述
alert	Object of AlertPoint	-	提示信息。
value	Double	123	指标值。
timestamp	Long	1665417600	指标发生时间（Unix时间戳）。
readable_timestamp	String	2022-10-11	指标发生时间（自然时间）。

AlertPoint

参数	类型	示例值	描述
msg	String	No error	提示信息。
alert	Boolean	true	是否需要提示。

返回示例

错误码

当前接口暂无独立错误码，若接口调用返回异常，可参考公共错误码进行故障排查。

最近更新时间：2026.10.15 20:24:46

这个页面对您有帮助吗？

有用

有用

无用

无用