开始使用
核心概念
理解监控网站、API Key、访客、会话、页面访问和四类监控数据之间的关系。
理解下面几个概念,可以帮助你正确解读控制台数据,也能避免在自定义事件中重复记录已有上下文。
监控网站与 API Key
监控网站是数据隔离和接收量计算的基本单位,通常对应一个正式站点或一个独立环境。每个监控网站有自己的域名、API Key 和每月接收量。免费版账户可添加 1 个监控网站。
API Key随 SDK 请求发送,用于把数据归属到对应网站。它不是管理后台的登录凭据,除查询公开 PV/UV 概览外,不能用于读取完整监控数据或修改配置。
访客、会话与页面访问
| 概念 | 标识保存位置 | 何时变化 | 用途 |
|---|---|---|---|
访客 visitor_id | localStorage | 本地存储被清理或不可用时 | 估算独立访客 UV |
会话 session_id | sessionStorage | 新标签页或会话存储重建时 | 关联同一浏览器会话 |
页面访问 page_view_id | 内存 | 首次打开及 SPA 路由变化时 | 关联当前页面的性能、事件和错误上下文 |
这些标识是随机生成的技术标识,不等同于登录用户 ID。平台默认不知道访客的真实姓名、账号或联系方式。
四类监控数据
页面访问
包含 URL、路径、标题、来源、视口、屏幕、语言、时区、网络信息、导航类型和 SDK 版本等,用于计算访问趋势与环境分布。
性能
包含 LCP、CLS、INP、FCP、TTFB、TBT、DOMContentLoaded 和 Load。不同浏览器支持的 Performance API 不同,因此单次访问不一定具备所有指标。
错误
包含错误类型、消息、堆栈、当前访问上下文、最近行为面包屑和开发者主动提供的附加信息。
业务事件
平台不会自动采集业务事件,而是由网站在代码中调用 TraceVista.track() 主动上报,例如注册完成、结算成功或筛选条件变更。SDK 会自动附加当前访问上下文。
数据接收量
免费账号可监控 1 个网站,账号每个自然月拥有 200 MB 上下文 data 接收量和 3000 次事件触发额度。额度用完后,账号下网站当月停止接收新数据,已有数据和网站配置不会被删除。手动清空历史数据不会返还当月已经使用的额度。
