You need to enable JavaScript to run this app.
导航

GetAppStartupMultiTrend

最近更新时间2023.12.26 16:39:08

首次发布时间2023.03.13 16:59:23

调用GetAppStartupMultiTrend接口获取App启动分析的趋势。

使用说明

  • 接口名称:GetAppStartupMultiTrend
  • 请求方式:POST
  • 接口地址:/?Action=GetAppStartupMultiTrend&Version=2022-10-12

请求参数

Query

参数

类型

是否必选

示例值

描述

Action

string

GetAppStartupMultiTrend

请求名称。

Version

string

2022-10-12

请求版本。

ServiceName : apmplus_openapi
Region : cn-beijing 
X-App-Ids : xxx
Content-Type : application/json

Body

参数

类型

是否必选

示例值

描述

start_time

i32

1678032000

开始时间。

end_time

i32

1678674278

终止时间。

filters

object of filters

-

筛选条件。

granularity

i32

1440

聚合度,单位分钟。

group_by_field

string

-

分组字段,不分组的情况下传空字符串。

metrics

array of string

startup_count

指标列表。

  • startup_count:启动数量
  • startup_time_avg:启动时间平均值
  • time_pct50:启动时间50分位
  • time_pct75:启动时间75分位
  • time_pct95:启动时间95分位
  • time_pct99:启动时间99分位

filters

参数

类型

是否必选

示例值

描述

type

string

and

筛选条件类型。

  • expression:表达式
  • map:映射
  • and:且条件
  • or:或条件

op

string

in

操作符。

  • in:包含

dimension

string

os

条件的名称。

  • os_version:系统版本
  • device_model:机型
  • app_version:App版本
  • update_version_code:App小版本
  • npth_version:APM SDK版本
  • channel:下载渠道
  • rom:ROM信息
  • province:省份
  • process_name:进程名
  • device_manufacturer:厂商
  • last_scene:App页面
  • os:系统
  • launch_mode:启动模式

values

array of string

["Android"]

筛选值,支持多个。
例如,dimension为launch_mode时,values为:

  • 0:首次启动
  • 1:冷启动
  • 2:热启动
  • 3:温启动

value

string

Android

筛选值。

map_key

string

key_1

map类型key,当type为map时必填。

sub_conditions

array of sub_conditions

-

子条件。

sub_conditions

参数

类型

是否必选

示例值

描述

type

string

expression

筛选条件类型。

  • expression:表达式
  • map:映射
  • and:且条件
  • or:或条件

op

string

in

操作符。

  • in:包含

dimension

string

os

条件的名称。

values

array of string

[
"Android"
]

筛选值,支持多个。

value

string

Android

筛选值。

map_key

string

key_1

map类型key,当type为map时必填。

sub_conditions

array of string

-

子条件。

返回参数

参数

类型

示例值

描述

data

string

-

错误返回数据。
key为指标名,对应request里的metric不分组的请求下,list只有一个元素,分组情况下会有多个元素,每个元素代表趋势图里的一条线。

error_msg

string

-

错误信息。

error_no

i32

0

错误码。

请求示例

POST https://open.volcengineapi.com/?Action=GetAppStartupMultiTrend&Version=2022-10-12 

{
    "start_time":1678032000,
    "end_time":1678674278,
    "filters":{
        "type":"and",
        "sub_conditions":[
            {
                "dimension":"os",
                "op":"in",
                "type":"expression",
                "values":[
                    "Android"
                ]
            }
        ]
    },
    "granularity":1440,
    "metrics":[
        "startup_count"
    ]
}

返回示例

正常返回示例

{
    "err_detail":"",
    "data":{
        "startup_count":[
            {
                "name":"",
                "points":[
                    {
                        "timestamp":1678032000,
                        "readable_timestamp":"2023-03-06 00:00:00",
                        "value":687,
                        "alert":{
                            "alert":false,
                            "msg":""
                        }
                    },
                    {
                        "timestamp":1678550400,
                        "readable_timestamp":"2023-03-12 00:00:00",
                        "value":937,
                        "alert":{
                            "alert":false,
                            "msg":""
                        }
                    },
                    {
                        "timestamp":1678636800,
                        "readable_timestamp":"2023-03-13 00:00:00",
                        "value":411,
                        "alert":{
                            "alert":false,
                            "msg":""
                        }
                    }
                ],
                "total":5872
            }
        ]
    },
    "error_msg":"",
    "error_no":0
}

异常返回示例

{
    "ResponseMetadata": {
        "RequestId": "20180***2D30",
        "Action": "GetAppStartupMultiTrend",
        "Version": "2022-10-12",
        "Service": "***",
        "Region": "cn-north-1",
        "Error": {
            "Code": "200000",
            "Message": "参数异常"
        }
    }
}