调用QueryLaunchTimeDistribution查询启动耗时分布。
应用需提前接入性能分析SDK。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | QueryLaunchTimeDistribution |
系统规定参数。取值:QueryLaunchTimeDistribution。 |
UniqueAppId | String | 是 | 24781204@android |
用于唯一标识App。 格式:appkey@{platfrom} 其中{platfrom}为应用所属平台:
|
AppVersionStrategy | String | 否 | LATEST_3 |
用于设置应用的版本策略。 格式:LATEST_{N},代表取最近的N个版本。其中,{N}的最大取值为10。 说明:
|
StartTime | Long | 是 | 1609430400000 |
用于设置查询时间区间的开始时间。 |
EndTime | Long | 是 | 1609862400000 |
用于设置查询时间区间的结束时间。 |
IntervalMinutes | Integer | 否 | 1440 |
用于设置查询结果的时间精度,以分钟为单位。 最高精度为1440分钟(1天);默认精度为1440分钟;参数取值需为1440的倍数。 |
DeviceLevel | String | 是 | high |
用于设置设备分类。 取值范围:
|
LaunchType | String | 否 | COLD |
用于设置应用启动类型。 取值范围:
说明:如未设置本参数,则默认为不区分启动类型。 |
AppVersion.N | String | 否 | 1.0 |
用于设置应用的版本号。 格式为:{N}.x. ... .x,其中,{N}的取值范围为1~10。 说明:
|
Province.N | String | 否 | 北京市 |
用于设置地域列表。默认不区分地域。 取值范围:"北京市", "天津市", "上海市", "重庆市", "河北省", "山西省", "辽宁省", "吉林省", "黑龙江省", "江苏省", "浙江省", "安徽省","福建省", "江西省", "山东省", "河南省", "湖北省", "湖南省", "广东省", "海南省", "四川省", "贵州省", "云南省", "陕西省","甘肃省", "青海省", "中国台湾", "内蒙古自治区", "广西壮族自治区", "西藏自治区", "宁夏回族自治区", "新疆维吾尔自治区","香港特别行政区", "澳门特别行政 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | A23AE171-3B22-45E7-8767-EA7C0A1A9991 |
用于显示查询请求的ID。 |
MetricResultList | Array of MetricResultItem |
用于显示结果列表。 |
|
Tags | Map |
用于显示标签组合。 |
|
Data | Array of Point |
用于显示某个标签组合的数据。 |
|
Time | Long | 1609862400000 |
用于显示时间戳。 |
CentroidItemList | Array of CentroidItem |
用于显示启动耗时分布数据列表。 |
|
Range | String | 300以下 |
用于显示耗时范围,单位为毫秒。 |
Value | Float | 1100 |
用于显示启动耗时在当前区间内的日志数。 |
Rate | Float | 25.0 |
用于显示启动耗时在当前区间内的日志占比。 |
示例
请求示例
http(s)://[Endpoint]/?Action=QueryLaunchTimeDistribution
&DeviceLevel=high
&EndTime=1609862400000
&StartTime=1609430400000
&UniqueAppId=24781204@android
&AppVersionStrategy=LATEST_3
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>A23AE171-3B22-45E7-8767-EA7C0A1A9991</RequestId>
<MetricResultList>
<Tags>
<appVersion>1.0</appVersion>
<deviceLevel>high</deviceLevel>
</Tags>
<Data>
<Time>1609862400000</Time>
<CentroidItemList>
<Value>1100</Value>
<Range>300以下</Range>
<Rate>25.0</Rate>
</CentroidItemList>
<CentroidItemList>
<Value>1000</Value>
<Range>300-500</Range>
<Rate>23.0</Rate>
</CentroidItemList>
</Data>
</MetricResultList>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "A23AE171-3B22-45E7-8767-EA7C0A1A9991",
"MetricResultList" : [ {
"Tags" : {
"appVersion" : "1.0",
"deviceLevel" : "high"
},
"Data" : [ {
"Time" : "1609862400000",
"CentroidItemList" : [ {
"Value" : "1100",
"Range" : "300以下",
"Rate" : "25.0"
}, {
"Value" : "1000",
"Range" : "300-500",
"Rate" : "23.0"
} ]
} ]
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidAppId | The AppId you provided is invalid. | 您提供的AppId不合法。 |
400 | InvalidParameters | The specified parameter is invalid. | 参数不合法。 |
400 | InvalidRequest | The request is invalid. | 请求不合法。 |
500 | InternalError | An error occurred while processing your request. | 服务出错。 |
403 | Forbidden.NoPermission | You are not authorized to access data related to the specified AppId. | 您无权访问与该AppId有关的数据。 |
403 | Forbidden.NoRAMPermission | Your RAM account is not authorized to access the data of the specified AppId. | 您使用的RAM子账号没有被授权访问该AppId的数据。 |
406 | UnexpectedAppStatus | The status of App is invalid. | App的状态不合法。 |
访问错误中心查看更多错误码。