友盟应用性能监控(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。
获取路径:
- 打开友盟官网:https://www.umeng.com/
- 登录后进入对应应用的管理后台
- 在「应用信息」或「集成设置」中复制 appKey
- 将 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工具
相关专题
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。
0
2026.11.17
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.9万人学习
共6课时 | 54.8万人学习