1. 慢帧的定义与 APM 监控目标

慢帧是 APM 监控中衡量用户交互流畅性的关键概念。当单帧渲染耗时超过合理阈值时，用户会感受到界面卡顿、响应迟滞，直接降低应用体验。本章从判定标准、帧率与卡顿的内在关系、核心监控指标三个维度建立慢帧的完整定义。

1.1 慢帧判定标准

1.2 帧率与卡顿的关系

帧率（FPS）是每秒渲染帧数的平均值，无法体现单帧抖动。两台设备可能都输出 30 FPS，但一台帧间隔均匀（每帧 33 ms），另一台存在 50 ms 的突发帧——后者用户感知明显卡顿。因此 APM 必须从“帧率中心”转向“帧耗时分布”。

1.3 监控核心指标

1.4 实现流程：构建慢帧监控目标

1. 确定目标帧率（60/90/120 Hz）与对应阈值。
2. 在渲染管线结束位置插入打点（Choreographer / CADisplayLink）。
3. 采集原始帧耗时，计算滑动窗口内的分位值。
4. 定义慢帧判定逻辑：帧耗时 > 阈值 或 帧间隔抖动 > 阈值。
5. 设计告警规则：慢帧率连续三分钟超过 3% 则发起告警。

1.5 配置示例（YAML）

slow_frame:
  target_fps: 60
  threshold_ms: 16.67
  freeze_threshold_ms: 700
  window_seconds: 60
  alarm_slow_ratio: 0.03
  alarm_freeze_count: 2
  aggregation: p95

1.6 调试与验证

[APM] Frame 12345 duration=18.2ms → SLOW (threshold 16.67ms)
[APM] Frame 12346 duration=15.1ms → OK
[APM] Slow ratio in last 60s: 4.1% → alarm triggered

1.7 部署要点

• 采集逻辑嵌入应用启动阶段，作为后台服务。
• 避免在渲染线程执行采集计算，使用独立线程或异步回调。
• 上报频率限制：每 10 秒聚合一次指标，减少网络开销。

1.8 常见错误

1.9 性能与稳定性优化

• 使用采样率代替全量采集：在告警触发前按 1% 采样，告警后提升至 10% 以收集细节。
• 缓存帧时间环状缓冲区，避免频繁分配内存。
• 告警去重：相同原因慢帧在 5 分钟内只发送一次通知。