You need to enable JavaScript to run this app.
导航
GetAppExceptionalBatterySummaryData
最近更新时间:2024.06.18 17:22:42首次发布时间:2024.04.25 17:57:50

获取App电量指标。

请求说明

  • 请求方式:POST
  • 请求地址:https://open.volcengineapi.com?Action=GetAppExceptionalBatterySummaryData&Version=2024-04-09
ServiceName : apmplus_openapi
Region : cn-beijing
X-App-Ids : xxx
Content-Type : application/json

请求参数

Query

参数类型是否必选示例值描述
ActionStringGetAppExceptionalBatterySummaryData接口名称。当前 API 的名称为 GetAppExceptionalBatterySummaryData
VersionString2024-04-09接口版本。当前 API 的版本为 2024-04-09

Body

参数类型是否必选示例值描述
start_timeInteger1619827200当前时段起始时间(Unix时间戳)。
end_timeInteger1619913600当前时段结束时间(Unix时间戳)。
filtersObject of Condition-筛选条件,可以指定多个键值对来筛选数据。
compare_start_timeInteger1619730800对比时段起始时间(Unix时间戳)。
compare_end_timeInteger1619817200对比时段结束时间(Unix时间戳)。
is_newInteger1新增issue。
statusArray of String["closed"]要考虑的处理状态。
managersArray of Long[123456789, 987654321]要考虑的责任人ID列表。
tagsArray of Long[111, 222]要考虑的标签ID列表。
tokenStringkeyword搜索关键字。

Condition

参数类型是否必选示例值描述

op

String

in

操作符。

  • gt:大于
  • gte:大于等于
  • lt:小于
  • lte:小于等于
  • eq:等于
  • neq:不等于
  • in:包含
  • not_in:不包含
  • lk:like
  • nlk:not like
  • regex:正则匹配
  • not_null:非正则匹配

type

String

expression

筛选条件类型。

  • expression:当前condition是一个表达式
  • and:当前condition是一个复合表达式,多个sub_condition的逻辑关系是and
  • or:当前condition是一个复合表达式,多个sub_condition的逻辑关系是or
  • map:当前condition是map类型
valueString123456筛选值。
valuesArray of String[123456]筛选值,支持多个。
map_keyStringkey_1map类型key,当type为map时必填。
dimensionStringaid条件的名称。
sub_conditionsArray of Condition-子条件。

返回参数

参数类型示例值描述
dataObject of SummaryResponseData-返回内容。
error_msgString-错误信息。
error_noInteger0错误码。

SummaryResponseData

参数类型示例值描述
battery_trace_cntObject of SummaryMetric-电量异常事件数量指标
battery_trace_userObject of SummaryMetric-影响用户数量指标
battery_trace_ratioObject of SummaryMetric-异常率
battery_trace_user_ratioObject of SummaryMetric-影响用户比例指标

SummaryMetric

参数类型示例值描述
rateDouble1.1变化率。
compareDouble90.0对比值。
currentDouble100.0当前值。

请求示例

POST https://open.volcengineapi.com?Action=GetAppExceptionalBatterySummaryData&Version=2024-04-09
{
    "start_time": 1619827200,
    "end_time": 1619913600,
    "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"
                ]
            }
        ]
    },
    "compare_start_time": 1619730800,
    "compare_end_time": 1619817200,
    "is_new": 1,
    "status": [
        "closed"
    ],
    "managers": [
        123456789,
        987654321
    ],
    "tags": [
        111,
        222
    ],
    "token": "keyword"
}

返回示例

{
    "data": {
        "battery_trace_cnt": {
            "rate": 1.1,
            "compare": 90,
            "current": 100
        },
        "battery_trace_user": {
            "rate": 1.1,
            "compare": 90,
            "current": 100
        },
        "battery_trace_ratio": {
            "rate": 1.1,
            "compare": 90,
            "current": 100
        },
        "battery_trace_user_ratio": {
            "rate": 1.1,
            "compare": 90,
            "current": 100
        }
    },
    "error_msg": "",
    "error_no": 0
}

错误码

本接口无特有的错误码。更多信息请参见错误码