开始使用

核心概念

理解监控网站、API Key、访客、会话、页面访问和四类监控数据之间的关系。

理解下面几个概念,可以帮助你正确解读控制台数据,也能避免在自定义事件中重复记录已有上下文。

监控网站与 API Key

监控网站是数据隔离和接收量计算的基本单位,通常对应一个正式站点或一个独立环境。每个监控网站有自己的域名、API Key 和每月接收量。免费版账户可添加 1 个监控网站。

API Key随 SDK 请求发送,用于把数据归属到对应网站。它不是管理后台的登录凭据,除查询公开 PV/UV 概览外,不能用于读取完整监控数据或修改配置。

访客、会话与页面访问

概念标识保存位置何时变化用途
访客 visitor_idlocalStorage本地存储被清理或不可用时估算独立访客 UV
会话 session_idsessionStorage新标签页或会话存储重建时关联同一浏览器会话
页面访问 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 次事件触发额度。额度用完后,账号下网站当月停止接收新数据,已有数据和网站配置不会被删除。手动清空历史数据不会返还当月已经使用的额度。

继续阅读 会员方案 或 接收量规则。