讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

友盟崩溃与性能数据查询

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 分钟)
目录

热门AI工具

更多
讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

相关专题

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.12

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

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

0

2026.11.12

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

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

0

2026.11.12

热门下载

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

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn