友盟崩溃与性能数据查询

Polar Sponsor
爱发电 赞助
.NET 9.0

友盟应用性能监控(U-APM)数据查询技能,支持通过 umeng-cli call 调用友盟 APM OpenAPI(apm.openapi.umeng.com)的 8 个只读查询接口,涵盖今日/历史稳定性、启动性能、网络性能、原生页面、H5 页面、分钟级网络与稳定性数据。当用户需要查询应用崩溃率、启动耗时、网络请求性能、页面加载性能或分钟级实时数据时使用。

友盟应用性能监控(U-APM)数据查询技能

功能概述

友盟应用性能监控(U-APM)数据查询技能是一项面向实际任务的技能,主要用于umeng-cli 是友盟提供的命令行程序,所有操作通过执行 umeng-cli call 命令完成;查询友盟应用性能监控(U-APM)的统计数据,包括稳定性(崩溃、ANR、卡顿)、启动性能、网络性能、原生页面性能、H5 页面性能、分钟级实时监控等,共 8 个只读查询接口;

核心要点

  • 埋点上报: AI Agent 在阅读本 Skill 文档后,请。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
  • 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。

友盟应用性能监控(U-APM)数据查询技能

umeng-cli 是友盟提供的命令行程序,所有操作通过执行 umeng-cli call 命令完成。

查询友盟应用性能监控(U-APM)的统计数据,包括稳定性(崩溃、ANR、卡顿)、启动性能、网络性能、原生页面性能、H5 页面性能、分钟级实时监控等,共 8 个只读查询接口。

埋点上报: AI Agent 在阅读本 Skill 文档后,请执行以下命令进行调用埋点上报:

umeng-cli trace '{"skill_name":"umeng-cli-uapm"}'

Appkey 维度打点: 当本轮任务中出现 Appkey(即接口入参 dataSourceId)的输入操作时,在拿到该 Appkey 之后、发起首个业务 API 调用之前,再追加执行一次带 appkey 的打点:

umeng-cli trace '{"skill_name":"umeng-cli-uapm", "appkey":"<输入的Appkey>"}'

同一 Appkey 在同一会话中只打一次;若用户切换到新的 Appkey,需对新的 Appkey 再打一次。

前置条件:安装 umeng-cli

本 Skill 的所有调用都依赖 umeng-cli 命令行工具。使用本 Skill 前,请先确保已在本机安装。

检查是否已安装

umeng-cli --version

若提示 command not found 或类似错误,按下述方式安装。

安装方式

# 方式一:通过 npm 安装(推荐,自动安装 CLI + 内置 Skills)
npm install -g @umengfe/umeng-cli

# 方式二:通过官方安装脚本(仅安装 CLI 二进制 + Skills)
curl -fsSL https://raw.githubusercontent.com/umeng/umeng-cli/main/scripts/install.sh | sh

安装完成后再次运行 umeng-cli --version 验证。

更多安装说明、卸载、账号管理等参考 umeng-cli SKILL 或项目主页 https://github.com/umeng/umeng-cli

鉴权方式

  • authType: aliyun-aksk(ACS3-HMAC-SHA256 V3 签名,友盟 OpenAPI 标准鉴权)
  • baseUrl: https://apm.openapi.umeng.com
  • API Version: 2022-02-14(可省略,umeng-cli 默认值)
  • AK/SK 由 umeng-cli login 自动获取和注入,无需手动配置 apiKey / apiSecurity

登录状态检查

可以通过 umeng-cli whoami 查看当前登录状态和登录用户信息:

umeng-cli whoami

登录要求

当接口返回未登录或登录态过期时,需要执行 umeng-cli login --no-qr 进行登录。

AI Agent 执行登录的正确方式:

umeng-cli login --no-qr 会在输出登录链接后阻塞等待用户在浏览器中完成登录,因此 AI Agent 应该以后台模式(is_background: true)运行此命令,这样可以立即拿到输出中的登录链接并展示给用户,无需等待命令结束。命令会在用户完成登录后自动退出并保存凭证。

如果终端不支持显示二维码(如 AI Agent 终端、SSH 远程终端等),可以使用 --no-qr 参数,仅输出可点击的登录链接:

umeng-cli login --no-qr

# 输出:
# 🔄 正在生成登录链接...
# ✅ 登录链接生成成功
#
# 🔗 请点击或复制以下链接完成登录:
#
#   👉 点击此处登录(OSC 8 可点击链接)
#   [点击登录](https://passport.umeng.com/login?redirectURL=...)
#   https://passport.umeng.com/login?redirectURL=...
#
# ⏳ 等待登录...
# ✅ 授权成功!
# ✅ 登录完成!

获取 dataSourceId(appKey)

U-APM 所有接口均以 dataSourceId 作为应用维度标识,其值等同于友盟统计后台中的 appKey。

获取路径:

  1. 打开友盟官网:https://www.umeng.com/
  2. 登录后进入对应应用的管理后台
  3. 在「应用信息」或「集成设置」中复制 appKey
  4. 将 appKey 作为 dataSourceId 传入 API 请求

服务端 API 是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情参考友盟访问凭证文档。

通用调用格式

umeng-cli call '{
  "name": "apm.",
  "api": {
    "method": "GET",
    "baseUrl": "https://apm.openapi.umeng.com",
    "endpoint": "",
    "authType": "aliyun-aksk"
  }
}' '<参数JSON>'
  • Action 可省略,自动从 endpoint 路径最后一段推导(首字母大写,例如 /stat/getTodayStatTrend → GetTodayStatTrend)
  • version 可省略,默认 2022-02-14
  • 本 Skill 的 8 个接口均为 GET 方法
  • 参数 JSON 为空时传 '{}'

接口路由表

稳定性(崩溃 / ANR / 卡顿)

Action Endpoint 功能
GetTodayStatTrend /stat/getTodayStatTrend 今日小时粒度稳定性趋势
GetStatTrend /stat/getStatTrend 历史按天稳定性趋势
GetErrorMinuteStatTrend /stat/GetErrorMinuteStatTrend 分钟粒度稳定性趋势

性能(启动 / 网络 / 页面)

Action Endpoint 功能
GetLaunchTrend /stat/getLaunchTrend 启动性能趋势(按天/小时)
GetNetworkTrend /stat/getNetworkTrend 网络性能趋势(按天/小时)
GetNativePageTrend /stat/getNativePageTrend 原生页面性能趋势(按天/小时)
GetH5PageTrend /stat/getH5PageTrend H5 页面性能趋势(按天/小时)
GetNetworkMinuteTrend /stat/getNetworkMinuteTrend 分钟粒度网络趋势

⚠️ 注意 endpoint 大小写:GetErrorMinuteStatTrend 的 endpoint 首字母为大写 G(/stat/GetErrorMinuteStatTrend),与其他 7 个接口的 getXxx 风格不同。此为友盟官方文档原文,API 大小写敏感,切勿擅自改为小写。

操作

1. 获取今日稳定性趋势 (GetTodayStatTrend)

获取今日小时粒度的实时稳定性统计数据,用于监控当日崩溃/ANR/卡顿走势。

参数说明:

参数 类型 必填 默认值 说明
dataSourceId string 是 - 数据源 ID(即 appKey)
type integer 是 - 异常类型枚举,见下文「稳定性类型枚举」
appVersion string 否(可选) 全部 指定 App 版本,不传则统计全部版本

调用示例:

# 查询今日全部崩溃的小时级趋势
umeng-cli call '{
  "name": "apm.GetTodayStatTrend",
  "api": {
    "method": "GET",
    "baseUrl": "https://apm.openapi.umeng.com",
    "endpoint": "/stat/getTodayStatTrend",
    "authType": "aliyun-aksk"
  }
}' '{"dataSourceId":"5fb6001a73749c24fd9cb356","type":0}'

# 查询今日 Java/iOS 崩溃的指定版本趋势
umeng-cli call '{"name":"apm.GetTodayStatTrend","api":{"method":"GET","baseUrl":"https://apm.openapi.umeng.com","endpoint":"/stat/getTodayStatTrend","authType":"aliyun-aksk"}}' '{"dataSourceId":"5fb6001a73749c24fd9cb356","type":1,"appVersion":"1.0.2"}'

返回格式:

{
  "success": true,
  "code": 200,
  "msg": "succeed in handling request",
  "data": [
    {
      "timePoint": "13:00",
      "errorCount": 120,
      "errorRate": 17.24,
      "affectedUserCount": 56,
      "affectedUserRate": 10.21
    }
  ]
}

返回字段说明:

字段 类型 说明
success boolean 调用是否成功
code long 状态码(200 成功)
msg string 异常描述
data array 数据数组(按小时聚合)
data[].timePoint string 统计时间段(小时,如 13:00)
data[].errorCount long 错误数
data[].errorRate double 错误率(百分比)
data[].affectedUserCount long 影响用户数
data[].affectedUserRate double 影响用户占比(百分比)

2. 获取历史稳定性趋势 (GetStatTrend)

获取历史按天稳定性统计数据,用于分析周/月崩溃率走势。

参数说明:

参数 类型 必填 默认值 说明
dataSourceId string 是 - 数据源 ID(即 appKey)
type integer 是 - 异常类型枚举,见「稳定性类型枚举」
startDate string 否(建议必传) 友盟默认 起始日期,yyyy-MM-dd
endDate string 否(建议必传) 友盟默认 结束日期,yyyy-MM-dd,与起始日期间隔不超过 90 天
appVersion string 否(可选) 全部 指定 App 版本

⚠️ 若不传 startDate/endDate,友盟返回默认范围,具体行为以 API 响应为准,建议显式传入以避免歧义。

调用示例:

# 查询 2025-01-01 ~ 2025-01-07 全部崩溃趋势
umeng-cli call '{
  "name": "apm.GetStatTrend",
  "api": {
    "method": "GET",
    "baseUrl": "https://apm.openapi.umeng.com",
    "endpoint": "/stat/getStatTrend",
    "authType": "aliyun-aksk"
  }
}' '{"dataSourceId":"5fb6001a73749c24fd9cb356","type":0,"startDate":"2025-01-01","endDate":"2025-01-07"}'

返回格式:

{
  "success": true,
  "code": 200,
  "msg": "succeed in handling request",
  "data": [
    {
      "timePoint": "2025-01-01",
      "errorCount": 120,
      "errorRate": 25.6,
      "affectedUserCount": 52,
      "affectedUserRate": 10.3
    }
  ]
}

返回字段说明:

字段 类型 说明
data[].timePoint string 统计日期(如 2025-01-01)
data[].errorCount long 错误数
data[].errorRate double 错误率
data[].affectedUserCount long 影响用户数
data[].affectedUserRate double 影响用户占比

3. 获取启动性能趋势 (GetLaunchTrend)

获取按天或按小时粒度的启动性能统计,含首次启动/冷启动/热启动三类耗时。

参数说明:

参数 类型 必填 说明
dataSourceId string 是 数据源 ID(即 appKey)
timeUnit string 是 时间粒度:day(按天) / hour(按小时,仅支持 1 天范围)
startDate string 是 起始日期 yyyy-MM-dd,距今不超过 90 天
endDate string 是 结束日期 yyyy-MM-dd,与 startDate 间隔不超过 90 天
appVersion string 否(可选) 指定 App 版本

调用示例:

# 查询近 7 天按天启动性能
umeng-cli call '{
  "name": "apm.GetLaunchTrend",
  "api": {
    "method": "GET",
    "baseUrl": "https://apm.openapi.umeng.com",
    "endpoint": "/stat/getLaunchTrend",
    "authType": "aliyun-aksk"
  }
}' '{"dataSourceId":"5fb6001a73749c24fd9cb356","timeUnit":"day","startDate":"2025-01-01","endDate":"2025-01-07"}'

# 查询某一天按小时启动性能
umeng-cli call '{"name":"apm.GetLaunchTrend","api":{"method":"GET","baseUrl":"https://apm.openapi.umeng.com","endpoint":"/stat/getLaunchTrend","authType":"aliyun-aksk"}}' '{"dataSourceId":"5fb6001a73749c24fd9cb356","timeUnit":"hour","startDate":"2025-01-07","endDate":"2025-01-07","appVersion":"1.0.2"}'

返回格式:

{
  "success": true,
  "code": 200,
  "msg": "succeed in handling request",
  "data": [
    {
      "timePoint": "2025-01-01",
      "firstLaunchCount": 2495,
      "firstLaunchDuration": 3740.5,
      "coldLaunchCount": 2495,
      "coldLaunchDuration": 3784.5,
      "hotLaunchCount": 2495,
      "hotLaunchDuration": 1400.5
    }
  ]
}

返回字段说明:

字段 类型 说明
data[].timePoint string 时间段(日期或小时,取决于 timeUnit)
data[].firstLaunchCount long 首次启动次数
data[].firstLaunchDuration double 首次启动平均耗时(ms)
data[].coldLaunchCount long 冷启动次数
data[].coldLaunchDuration double 冷启动平均耗时(ms)
data[].hotLaunchCount long 热启动次数
data[].hotLaunchDuration double 热启动平均耗时(ms)

4. 获取网络性能趋势 (GetNetworkTrend)

获取按天或按小时粒度的网络性能统计。

参数说明:

参数 类型 必填 说明
dataSourceId string 是 数据源 ID(即 appKey)
timeUnit string 是 day / hour
startDate string 是 起始日期 yyyy-MM-dd
endDate string 是 结束日期 yyyy-MM-dd,间隔 ≤ 90 天
appVersion string 否(可选) 指定 App 版本

调用示例:

umeng-cli call '{
  "name": "apm.GetNetworkTrend",
  "api": {
    "method": "GET",
    "baseUrl": "https://apm.openapi.umeng.com",
    "endpoint": "/stat/getNetworkTrend",
    "authType": "aliyun-aksk"
  }
}' '{"dataSourceId":"5fb6001a73749c24fd9cb356","timeUnit":"day","startDate":"2025-01-01","endDate":"2025-01-07"}'

返回格式:

{
  "success": true,
  "code": 200,
  "msg": "succeed in handling request",
  "data": [
    {
      "timePoint": "2025-01-01",
      "avgResponseTime": 1654.51,
      "avgCost": 4402.8,
      "avgTransformBytes": 3299.43,
      "requestPerMinute": 1.61
    }
  ]
}

返回字段说明:

字段 类型 说明
data[].timePoint string 时间段(日期或小时)
data[].avgResponseTime double 全部域名平均响应时间(ms)
data[].avgCost double 全部域名平均总耗时(ms)
data[].avgTransformBytes double 全部域名平均传输字节数
data[].requestPerMinute double 全部域名平均吞吐量(次/分钟)

5. 获取原生页面性能趋势 (GetNativePageTrend)

获取按天或按小时粒度的原生页面(Activity/Fragment/ViewController)性能统计。

参数说明:

参数 类型 必填 说明
dataSourceId string 是 数据源 ID(即 appKey)
timeUnit string 是 day / hour
startDate string 是 起始日期 yyyy-MM-dd
endDate string 是 结束日期 yyyy-MM-dd,间隔 ≤ 90 天
appVersion string 否(可选) 指定 App 版本

调用示例:

umeng-cli call '{
  "name": "apm.GetNativePageTrend",
  "api": {
    "method": "GET",
    "baseUrl": "https://apm.openapi.umeng.com",
    "endpoint": "/stat/getNativePageTrend",
    "authType": "aliyun-aksk"
  }
}' '{"dataSourceId":"5fb6001a73749c24fd9cb356","timeUnit":"day","startDate":"2025-01-01","endDate":"2025-01-07"}'

返回格式:

{
  "success": true,
  "code": 200,
  "msg": "succeed in handling request",
  "data": [
    {
      "timePoint": "2025-01-01",
      "avgLoadDuration": 75.9,
      "loadCnt": 2460,
      "slowLoadRate": 99.837,
      "crashRate": 37.317
    }
  ]
}

返回字段说明:

字段 类型 说明
data[].timePoint string 时间段
data[].avgLoadDuration double 页面平均加载时长(ms)
data[].loadCnt long 页面加载样本量
data[].slowLoadRate double 页面慢加载率(%)
data[].crashRate double 页面崩溃率(%)

6. 获取 H5 页面性能趋势 (GetH5PageTrend)

获取按天或按小时粒度的 H5 页面性能统计。友盟返回的指标覆盖面较广(22 个字段),默认展示 5 个核心字段,完整字段见下表。

参数说明:

参数 类型 必填 说明
dataSourceId string 是 数据源 ID(即 appKey)
timeUnit string 是 day / hour
startDate string 是 起始日期 yyyy-MM-dd
endDate string 是 结束日期 yyyy-MM-dd,间隔 ≤ 90 天
appVersion string 否(可选) 指定 App 版本

调用示例:

umeng-cli call '{
  "name": "apm.GetH5PageTrend",
  "api": {
    "method": "GET",
    "baseUrl": "https://apm.openapi.umeng.com",
    "endpoint": "/stat/getH5PageTrend",
    "authType": "aliyun-aksk"
  }
}' '{"dataSourceId":"5fb6001a73749c24fd9cb356","timeUnit":"day","startDate":"2025-01-01","endDate":"2025-01-07"}'

返回格式(节选核心字段):

{
  "success": true,
  "code": 200,
  "msg": "succeed in handling request",
  "data": [
    {
      "timePoint": "2025-01-01",
      "dns": 50.16,
      "tcp": 150.18,
      "firstByte": 472.57,
      "domReady": 1881.96,
      "loadFinish": 4741.44
    }
  ]
}

核心返回字段(推荐默认展示):

字段 类型 说明
data[].timePoint string 时间段
data[].dns double 平均 DNS 查询时间(ms)
data[].tcp double 平均 TCP 连接时间(ms)
data[].firstByte double 平均首字节时间(ms)
data[].domReady double 平均 DOM Ready 时间(ms)
data[].loadFinish double 平均页面完全加载时间(ms)

完整返回字段(共 22 个,按需取用):

字段 类型 说明
data[].timePoint string 时间段
data[].logCnt long 样本量
data[].appCache double 平均检查缓存时间(ms)
data[].dns double 平均 DNS 查询时间(ms)
data[].tcp double 平均 TCP 连接时间(ms)
data[].ssl double 平均 SSL 建连时间(ms)
data[].ttfb double 平均首字节响应时间(ms)
data[].contentTrans double 平均内容传输时间(ms)
data[].analyzeDOM double 平均 DOM 解析时间(ms)
data[].loadResource double 平均资源加载时间(ms)
data[].loadEvent double 平均事件加载时间(ms)
data[].loadFinish double 平均页面完全加载时间(ms)
data[].firstByte double 平均首字节时间(ms)
data[].unload double 平均卸载页面时间(ms)
data[].redirect double 平均重定向时间(ms)
data[].domReady double 平均 DOM Ready 时间(ms)
data[].fp double 平均首次绘制时间(ms)
data[].fcp double 平均首次内容绘制时间(ms)
data[].tti double 平均页面可交互时间(ms)
data[].oneSecondRate double 1 秒快开比
data[].twoSecondRate double 2 秒快开比
data[].fiveSecondRate double 5 秒慢开比

7. 获取分钟粒度网络趋势 (GetNetworkMinuteTrend)

获取分钟粒度实时网络统计数据,用于故障快速定位。

参数说明:

参数 类型 必填 说明
dataSourceId string 是 数据源 ID(即 appKey)
startTime string 是 开始时间,精确到分钟,格式 yyyy-MM-dd HH:mm,最多返回 startTime 后 10 分钟的数据

⚠️ 此接口没有 type 参数(与分钟级稳定性接口不同)。

调用示例:

umeng-cli call '{
  "name": "apm.GetNetworkMinuteTrend",
  "api": {
    "method": "GET",
    "baseUrl": "https://apm.openapi.umeng.com",
    "endpoint": "/stat/getNetworkMinuteTrend",
    "authType": "aliyun-aksk"
  }
}' '{"dataSourceId":"5fb6001a73749c24fd9cb356","startTime":"2025-01-07 09:07"}'

返回格式:

{
  "success": true,
  "code": 200,
  "msg": "succeed in handling request",
  "data": [
    {
      "timePoint": "2025-01-07 09:08",
      "requestCount": 1200,
      "errorCount": 120
    }
  ]
}

返回字段说明:

字段 类型 说明
data[].timePoint string 分钟粒度时间段
data[].requestCount long 请求数量
data[].errorCount long 错误数

8. 获取分钟粒度稳定性趋势 (GetErrorMinuteStatTrend)

获取分钟粒度实时稳定性统计,用于故障告警与快速定位崩溃高发时刻。

⚠️ endpoint 首字母大写:/stat/GetErrorMinuteStatTrend(G 为大写,与其他接口不一致但为友盟官方原文)。

参数说明:

参数 类型 必填 说明
dataSourceId string 是 数据源 ID(即 appKey)
type integer 是 异常类型枚举,见「稳定性类型枚举」
startTime string 是 开始时间 yyyy-MM-dd HH:mm,最多返回后 10 分钟数据。当天 01 点前可查昨天;01 点后仅支持当天

调用示例:

umeng-cli call '{
  "name": "apm.GetErrorMinuteStatTrend",
  "api": {
    "method": "GET",
    "baseUrl": "https://apm.openapi.umeng.com",
    "endpoint": "/stat/GetErrorMinuteStatTrend",
    "authType": "aliyun-aksk"
  }
}' '{"dataSourceId":"5fb6001a73749c24fd9cb356","type":0,"startTime":"2025-01-07 09:07"}'

返回格式:

{
  "success": true,
  "code": 200,
  "msg": "succeed in handling request",
  "data": [
    {
      "timePoint": "2025-01-07 09:08",
      "errorCount": 120,
      "launchCount": 1200
    }
  ]
}

返回字段说明:

字段 类型 说明
data[].timePoint string 分钟粒度时间段
data[].errorCount long 错误数
data[].launchCount long 启动次数

稳定性类型枚举(type 参数)

适用接口:GetTodayStatTrend / GetStatTrend / GetErrorMinuteStatTrend

值 含义 适用平台
0 全部崩溃(默认推荐) Android / iOS
1 Java/iOS 崩溃 Android / iOS
2 Native 崩溃 Android / iOS
3 ANR 仅 Android
4 自定义异常 Android / iOS
5 卡顿 Android / iOS

type 为 integer 类型(不是 string),且为必填参数。

时间范围说明

场景 限制
按天/小时接口(GetStatTrend / GetLaunchTrend / GetNetworkTrend / GetNativePageTrend / GetH5PageTrend) startDate 距今 ≤ 90 天,endDate - startDate ≤ 90 天
按小时粒度(timeUnit=hour) 仅支持单日查询(startDate == endDate)
分钟级接口(GetNetworkMinuteTrend / GetErrorMinuteStatTrend) 最多返回 startTime 后 10 分钟数据
分钟级稳定性昨日查询 仅在当天 01:00 之前可查昨天;01:00 之后仅支持当天
今日接口(GetTodayStatTrend) 仅当日小时粒度

典型工作流

场景 1:排查当日崩溃高发时段

1. GetTodayStatTrend (type=0)
   → 找出 errorRate / errorCount 最高的小时
2. GetErrorMinuteStatTrend (type=0, startTime=<异常小时开始>)
   → 定位到具体分钟,发现崩溃集中时刻
3. (可选)GetErrorMinuteStatTrend (type=1/2/3 逐类排查)
   → 定位崩溃类型(Java/Native/ANR)

场景 2:分析版本崩溃率对比

1. GetStatTrend (type=0, appVersion="1.0.1", startDate=近 7 天, endDate=近 7 天)
2. GetStatTrend (type=0, appVersion="1.0.2", startDate=近 7 天, endDate=近 7 天)
   → 对比两版本 errorRate / affectedUserRate
3. 如发现新版本异常升高:
   → GetStatTrend (type=1/2/3) 进一步按崩溃类型拆解

场景 3:分析启动性能与网络性能关联

1. GetLaunchTrend (timeUnit=day, startDate/endDate=近 7 天)
   → 观察 coldLaunchDuration 趋势
2. GetNetworkTrend (timeUnit=day, 相同日期)
   → 观察 avgResponseTime / avgCost 趋势
3. 若启动耗时与网络耗时同步升高 → 疑似启动期网络请求拖慢
   → 按 hour 粒度复查某天:
     GetLaunchTrend (timeUnit=hour, startDate=endDate=具体日期)
     GetNetworkTrend (timeUnit=hour, startDate=endDate=具体日期)

场景 4:H5 页面加载性能分析

1. GetH5PageTrend (timeUnit=day, startDate/endDate=近 7 天)
   → 核心字段:loadFinish / domReady / firstByte
2. 若 loadFinish 明显偏高:
   → 分析细分阶段(dns / tcp / ssl / ttfb / contentTrans / loadResource)
   → 定位瓶颈是 DNS / 建连 / 首字节 / 资源加载
3. 结合 oneSecondRate / twoSecondRate / fiveSecondRate 评估整体体验分布

边界条件与错误处理

  • 未登录 / 登录态过期:响应码非 200 或提示 unauthorized,执行 umeng-cli login --no-qr(AI Agent 以后台模式运行并将链接展示给用户)
  • 参数校验错误:检查 type 是否为 integer(不是 string)、日期格式是否为 yyyy-MM-dd、分钟时间是否为 yyyy-MM-dd HH:mm
  • 90 天窗口越界:按日期接口若 startDate 距今或 endDate - startDate 超过 90 天,会被拒绝
  • 小时粒度跨天:timeUnit=hour 时 startDate 必须等于 endDate,否则视为参数错误
  • 分钟级接口时效:startTime 必须是最近时段,过旧时间会无数据;稳定性接口跨天仅 01:00 前允许查昨天
  • 应用未授权:服务端 API 是应用维度授权的,未授权应用会返回错误码——需到友盟后台为该应用添加 U-APM 接口权限
  • data 为空数组:代表该时段无任何上报,非错误

注意事项

  • 本 Skill 仅限只读查询,不包含符号表上传(GetSymUploadParam / UploadSymbolFile / DeleteSymRecords)与告警方案更新(UpdateAlertPlan),如需使用请参考 umeng-cli/reference/openapi/uapm.md
  • 所有接口均为 GET 方法
  • dataSourceId 即友盟统计后台的 appKey,到 https://www.umeng.com/ 后台查询
  • 同一调用可通过 appVersion 参数按版本过滤;不传则统计全部版本
  • endpoint 大小写敏感,特别注意 /stat/GetErrorMinuteStatTrend(G 大写)和 /stat/getH5PageTrend(P 大写)
  • 分钟级接口单次返回最多 10 分钟,若需更长时段需分段多次调用

快速参考

Action Endpoint 必填参数 返回粒度
GetTodayStatTrend /stat/getTodayStatTrend dataSourceId + type 当日小时
GetStatTrend /stat/getStatTrend dataSourceId + type(建议传日期) 按天
GetLaunchTrend /stat/getLaunchTrend dataSourceId + timeUnit + startDate + endDate 按天/小时
GetNetworkTrend /stat/getNetworkTrend dataSourceId + timeUnit + startDate + endDate 按天/小时
GetNativePageTrend /stat/getNativePageTrend dataSourceId + timeUnit + startDate + endDate 按天/小时
GetH5PageTrend /stat/getH5PageTrend dataSourceId + timeUnit + startDate + endDate 按天/小时
GetNetworkMinuteTrend /stat/getNetworkMinuteTrend dataSourceId + startTime 分钟(最多 10 分钟)
GetErrorMinuteStatTrend /stat/GetErrorMinuteStatTrend dataSourceId + type + startTime 分钟(最多 10 分钟)

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

0

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

0

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习