跳到主要内容

访问分析与近实时视图

访问分析是可选功能。不配置时,短链、登录和链接管理仍可用 — 图表、日志和近实时视图会是空的。

如何启用(三样都要)

需要同时具备:

  1. Analytics Engine 绑定,名称必须是 ANALYTICS

    • Workers: 通常由部署配置生成(数据集默认 sink
    • Pages: Settings → Bindings → Add → Analytics Engine
    • 变量名:ANALYTICS
    • 数据集:默认 sink。若设置了 NUXT_DATASET,这里必须相同
  2. 账户 ID — 把 NUXT_CF_ACCOUNT_ID 设为承载本应用的 Cloudflare 账户 ID
    (仪表盘侧边栏账户名,或登录后 URL 里可见)

  3. API 令牌 — 把 NUXT_CF_API_TOKEN 设为加密密钥:

    • Cloudflare 仪表盘 → 右上角头像 → My ProfileAPI TokensCreate TokenCustom Token
    • 权限仅需:Account → Account Analytics → Read
    • 建议限制到同一账户

缺一或名称不一致,访问分析会一直为空。

能看到什么

成功的访问会进入计数器、图表、热力图、最近事件和位置。可按链接、时间、国家/地区、浏览器、系统、设备、来源筛选。

数字可能是近似值(Cloudflare 会对大流量采样)。低流量时也可能看起来不均匀。

要从统计和点击 Webhook 排除机器人,设置 NUXT_DISABLE_BOT_ACCESS_LOG=true

近实时页面

不是真正的实时流

这个页面不用 WebSocket。大约每 10 秒刷新一次,并以大约每秒 1 个事件回放。暂停或标签页隐藏会停止回放。请当作“看起来像实时”的概览,而不是完整事件流。

导出

可在仪表盘或统计导出 API 下载筛选后的 CSV(短链码、URL、访客、访问量、来源等)。

链接 JSON 导出是另一项功能 — 见导入/导出