核心概念

应用（App / Workspace）

系统是以应用为中心的：每个接入的产品是一个应用，拥有独立的 workspace（错误/性能/行为/报表四块视图）和独立的采集 token。

• 超管在「设置 → 应用」创建应用，获得采集 token
• 超管可把应用指派给应用管理员（app_admin）维护
• 顶栏的 workspace 切换器在应用间切换

事件与 Envelope

SDK 上报的每一条数据都是一个 envelope：

{
  "type": "error | perf | event",
  "appId": "my-app",
  "release": "1.2.3",
  "platform": "web",
  "timestamp": 1787000000000,
  "sessionId": "…",
  "user": { "deviceId": "…", "userId": "…" },
  "context": { "url": "…", "userAgent": "…", "ua_browser": "Chrome 126" },
  "breadcrumbs": [],
  "payload": {}
}

批量 NDJSON 上报，失败落本地缓存下次补发。

Issue 聚合

相同错误按 fingerprint（message + 首个堆栈帧 + 页面 URL 的哈希）聚合为一个 issue，避免同一错误刷屏。

Session

30 分钟无活动切割会话。错误详情页的「行为轨迹」按 sessionId 还原错误发生前后用户的完整操作序列。

分位数

性能指标看 P50/P75/P95/P99 而非均值。明细数据保留 30 天（TTL），小时级预聚合（t-digest 状态）保留一年——看板读预聚合，明细用于下钻。

脱敏

SDK 端默认过滤手机号、身份证、邮箱、银行卡号，敏感 key（password/token/secret 等）整值替换；接口地址去掉 query 参数。数据不出你的机房。