更新记录

1.1.0（2026-11-05）

• 首发：JS 错误/未处理 Promise/页面加载耗时/接口异常四维捕获。
• Android/iOS 原生崩溃兜底（UTS 参考）、本地队列+指数退避上报、本地错误查看面板。
• 深度增强：错误指纹聚类 Top 问题、P50/P95/P99 耗时分位数、版本健康度评分、趋势时间桶、确定性采样限流与突发重复抑制；本地面板新增错误聚合分析（Pro）。

平台兼容性

uni-app(4.0)

崩溃监控·性能采集 Pro（zl-apm-lite）

简介

uni-app 轻量 APM：JS 错误 / 未处理 Promise / 页面加载耗时 / 接口异常四维捕获，Native 崩溃兜底（UTS 参考），本地队列 + 指数退避批量上报到接入方自有服务端。仅采集错误与性能数据，不含个人信息。

功能特性

• 错误指纹聚类（Pro）：堆栈归一化 + FNV-1a 指纹，同一崩溃不再刷屏，直接看 Top 问题
• 耗时分位数（Pro）：页面加载 P50 / P95 / P99 与最大值
• 版本健康度（Pro）：错误率 45% + 慢加载 25% + 原生崩溃 30% 的可解释评分
• 趋势时间桶（Pro）：近 6 小时事件分布，补零可直接绘图
• 采样限流（Pro）：确定性采样 + 同指纹最小间隔，错误风暴不灌爆队列
• JS 错误、未处理 Promise 捕获
• 页面加载耗时、接口状态码/耗时采集
• Android/iOS 原生崩溃兜底（UTS 参考实现）
• 本地队列 + 指数退避批量上报
• 本地错误查看面板
• 事件去重降噪

平台兼容

App-Android、App-iOS、H5、微信小程序（原生崩溃仅 App 端）

快速上手

import { initApm } from '@/uni_modules/zl-apm-lite'
initApm({ endpoint: 'https://your-server/apm/collect', appKey: 'your-app' })

服务端部署

依赖 express；复制 server/apm-reference.js，启动后接收 /apm/collect 的批量事件并落库/聚合。

合规声明

仅采集错误信息（消息/堆栈）、页面路径与性能耗时；不采集个人信息；设备标识仅使用接入方自定的匿名 deviceId；数据仅上报到接入方配置的其自有服务端，插件方不经手、不存储。

常见问题

• Q：iOS/Android 崩溃没上报？ A：原生崩溃参考实现需在真机/云打包下验证，请按 VERIFICATION-RUNBOOK 核对。
• Q：事件太多？ A：内置去重降噪，可调整采样率。

更新说明

1.0.0 首发：四维捕获、原生崩溃兜底、本地队列上报、错误查看面板。 1.1.0 深度增强：错误指纹聚类 Top 问题、P50/P95/P99 分位数、版本健康分、6 小时趋势桶、确定性采样限流与突发抑制；组件新增错误聚合分析面板（Pro）。