Skip to main content
本文说明 Flutter SDK 采集哪些数据、如何上报,以及如何控制采集范围。所有事件都写入 source: "flutter"

事件类型

自动采集的上下文

每个事件会自动附带以下上下文(由原生层采集):
  • 应用信息serviceversionenv,以及 application.id
  • 设备信息:设备型号、操作系统与版本、屏幕尺寸
  • 会话信息session.id,按 sessionSamplingRate 采样
  • 连接信息:网络类型(如可用)
  • 用户信息:通过 setUserInfo 设置的 usr.id / usr.name / usr.email

性能数据

控制台会为 Flutter 应用展示「性能」页,并支持以下原生 iOS / Android 性能数据: 启动耗时、刷新率和内存指标由 vitalUpdateFrequency 控制,默认为 VitalsFrequency.average;设置为 null 可关闭。reportFlutterPerformance 只控制 Flutter 帧的 build / raster timing,默认关闭,不影响这些原生指标。

手动埋点

除了自动采集,你可以手动记录事件与属性。

采样与控制

数据脱敏

通过事件映射器(event mapper)可以在事件上报前修改或丢弃数据,用于脱敏或过滤噪声。详见 高级配置

上报行为

  • SDK 在原生层做批量缓存,按 batchSizeuploadFrequency 分批上报
  • 网络不可用时事件会持久化到本地,恢复后重试
  • 上报地址默认为 https://browser.flashcat.cloud/api/v2/rum;私有化部署可通过 customEndpoint 配置完整的 RUM intake URL(必须包含 /api/v2/rum,并保留部署的路径前缀)