You need to enable JavaScript to run this app.
文档中心
应用性能监控全链路版

应用性能监控全链路版

复制全文
下载 pdf
电量监控
GetAppExceptionalBatteryTrend
复制全文
下载 pdf
GetAppExceptionalBatteryTrend
获取App电量异常的趋势。​
请求说明​
应用性能监控全链路版客户端监控已在全球多个地域部署服务,旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅 服务地址 文档,根据业务所在地选择最合适的接入点。​
  • 请求方式:POST​
  • 请求地址:https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=GetAppExceptionalBatteryTrend&Version=2022-10-12​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数,更多详细信息参见 公共参数 。​
​
参数​
类型​
是否必选​
示例值​
描述​
Action​
String​
是​
GetAppExceptionalBatteryTrend​
接口名称。当前 API 的名称为 GetAppExceptionalBatteryTrend。​
Version​
String​
是​
2022-10-12​
接口版本。当前 API 的版本为 2022-10-12。​
start_time​
Integer​
否​
1617225600​
查询开始时间(Unix时间戳)。​
end_time​
Integer​
否​
1617312000​
查询结束时间(Unix时间戳)。​
filters​
Object of Condition​
否​
-​
筛选条件,可以指定多个键值对来筛选数据。​
granularity​
Integer​
否​
5​
聚合粒度,单位是分钟。​
metrics​
String​
否​
battery_trace_cnt​
指标名。​
issue_id​
String​
否​
xx_xx​
issue ID。​
is_new​
Integer​
否​
0​
是否新版本。​
  • 1:是新版本​
  • 0:不是新版本​
status​
Array of String​
否​
processing​
处理状态。​
  • pending:未修复​
  • processing:修复中​
  • ignored:已忽略​
  • solved:已修复​
  • reopen:重复出现​
managers​
Array of Long​
否​
[223421]​
按责任人筛选,传用户ID列表。​
tags​
Array of Long​
否​
[1,221]​
标签。​
token​
String​
否​
xxx​
搜索关键词。​
​
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​
否​
-​
子条件。​
​
请求示例​
​
POST https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=GetAppExceptionalBatteryTrend&Version=2022-10-12​
{​
"start_time": 1617225600,​
"end_time": 1617312000,​
"filters": {​
"type": "and",​
"sub_conditions": [​
{​
"dimension": "apm_version",​
"type": "expression",​
"op": "in",​
"values": [​
"1.4.5"​
]​
},​
{​
"dimension": "device_model",​
"type": "expression",​
"op": "in",​
"values": [​
"MI 5X"​
]​
}​
]​
},​
"granularity": 5,​
"metrics": "battery_trace_cnt",​
"issue_id": "xx_xx",​
"is_new": 0,​
"status": [​
"pleasant"​
],​
"managers": 223421,​
"tags": [​
1,​
221​
],​
"token": "xxx"​
}
​
返回参数​
​
参数​
类型​
示例值​
描述​
data​
Array of TrendLine​
-​
不分组的请求下,list只有一个元素,分组情况下会有多个元素,每个元素代表一条线。​
error_msg​
String​
success​
错误信息。​
error_no​
Integer​
0​
错误码。​
​
TrendLine​
​
参数​
类型​
示例值​
描述​
name​
String​
test123​
线的名称,在分组的情况下,name应该是分组维度的取值,比如用来显示曲线的图标。​
points​
Array of TrendPoint​
-​
曲线上的点。​
total​
Double​
​
总数​
​
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​
是否需要提示。​
​
返回示例​
​
{​
"data": [​
{​
"name": "test123",​
"points": [​
{​
"alert": "-",​
"value": 123,​
"timestamp": 1665417600,​
"readable_timestamp": "2022-10-11"​
}​
]​
}​
],​
"error_msg": "",​
"error_no": 0​
}
​
错误码​
当前接口暂无独立错误码,若接口调用返回异常,可参考 公共错误码 进行故障排查。​
最近更新时间:2025.09.02 10:10:12
这个页面对您有帮助吗?
有用
有用
无用
无用