调用QueryPagePerfTrend查询指定页面的性能趋势，包括页面启动耗时和页面滑动FPS。

应用需提前接入性能分析SDK。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 QueryPagePerfTrend

系统规定参数。取值：QueryPagePerfTrend。

UniqueAppId String 是 24781204@android

用于唯一标识App。

格式：appkey@{platfrom}

其中{platfrom}为应用所属平台：

  • Android应用的{platfrom}为android；
  • iOS应用的{platfrom}为iphoneos。
AppVersionStrategy String 否 LATEST_3

用于设置应用的版本策略。

格式：LATEST_{N}，代表取最近的N个版本。其中，{N}的最大取值为10。

说明：

  • 参数AppVersion.N与参数AppVersionStrategy，二者必选其一进行配置。
  • 当参数AppVersion.N已设置时，则本参数无需设置，或设置无效。
  • 当参数AppVersion.N未设置时，则本参数必须设置。
StartTime Long 是 1609430400000

用于设置查询时间区间的开始时间。
EndTime Long 是 1609862400000

用于设置查询时间区间的结束时间。
IntervalMinutes Integer 否 1440

用于设置查询结果的时间精度，以分钟为单位。

最高精度为1440分钟（1天）；默认精度为1440分钟；参数取值需为1440的倍数。
DeviceLevel String 是 high

用于设置设备分类。默认为不区分。

取值范围：

  • high：高端设备
  • middle：中端设备
  • low：低端设备
MetricType String 是 load_time

用于设置查询的指标类型。

取值范围：

  • load_time：启动耗时
  • fps：滑动FPS
StatType String 是 AVG

用于设置页面性能的统计方式。

取值范围：

  • AVG：平均值
  • MAX：最大值
  • MIN：最小值
  • P50：中位数
  • P90：90%分位数
  • P99：99%分位数
AppVersion.N String 否 1.0

用于设置应用的版本号。

格式为：{N}.x. ... .x，其中，{N}的取值范围为1~10。

说明：

  • 参数AppVersion.N与参数AppVersionStrategy，二者必选其一进行配置。
  • 当本参数已设置时，则参数AppVersionStrategy无需设置，或设置无效。
  • 当本参数未设置时，则参数AppVersionStrategy
Page.N String 否 com.aliyun.TestActivity

用于指定查询的应用页面。

  • Android场景：设置Activity的类名。
  • iOS场景：设置ViewController的名称。
Province.N String 否 北京市

地域列表，默认不区分地域。支持如下参数：

"北京市", "天津市", "上海市", "重庆市", "河北省", "山西省", "辽宁省", "吉林省", "黑龙江省", "江苏省", "浙江省", "安徽省","福建省", "江西省", "山东省", "河南省", "湖北省", "湖南省", "广东省", "海南省", "四川省", "贵州省", "云南省", "陕西省","甘肃省", "青海省", "中国台湾", "内蒙古自治区", "广西壮族自治区", "西藏自治区", "宁夏回族自治区", "新疆维吾尔自治区","香港特别行政区", "澳门特别行政区"

返回数据

名称 类型 示例值 描述
RequestId String BE343731-0AB2-45C2-B4A4-A0858D1FDD76

用于显示查询请求的ID。
MetricResultList Array of MetricResultItem

用于显示结果列表。
Tags Map

用于显示标签组合。
Data Array of Point

用于显示某个标签组合的数据。
Time Long 1609862400000

用于显示时间戳。
Data Float 134.2

用于根据参数StatType的设置，显示相应数据值。

  • 如参数StatType设置为AVG，显示页面性能的平均值。
  • 如参数StatType设置为MAX，显示页面性能的最大值。
  • 如参数StatType设置为MIN，显示页面性能的最小值。
  • 如参数StatType设置为P50，显示页面性能的中位数。
  • 如参数StatType设置为P90，显示页面性能的90%分位数。
  • 如参数StatType设置为P99，显示页面性能的99%分位数。

示例

请求示例

http(s)://[Endpoint]/?Action=QueryPagePerfTrend
&DeviceLevel=high
&EndTime=1609862400000
&MetricType=load_time
&StartTime=1609430400000
&StatType=AVG
&UniqueAppId=24781204@android
&AppVersionStrategy=LATEST_3
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>BE343731-0AB2-45C2-B4A4-A0858D1FDD76</RequestId>
<MetricResultList>
    <Tags>
        <appVersion>1.0</appVersion>
        <deviceLevel>high</deviceLevel>
    </Tags>
</MetricResultList>
<MetricResultList>
    <Data>
        <Time>1609862400000</Time>
        <Data>134.2</Data>
    </Data>
</MetricResultList>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "BE343731-0AB2-45C2-B4A4-A0858D1FDD76",
  "MetricResultList" : [ {
    "Tags" : {
      "appVersion" : "1.0",
      "deviceLevel" : "high"
    }
  }, {
    "Data" : {
      "Time" : 1609862400000,
      "Data" : 134.2
    }
  } ]
}

错误码

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的状态不合法。

访问错误中心查看更多错误码。