常见问题
选型、部署、接入和使用时最常被问到的问题。
产品
有没有商业版?
没有,也没有功能开关。服务端、仪表盘、SDK 全部 Apache-2.0,不存在专业版、企业版。收费的只有 人工服务,不解锁任何功能。
能不能做热力图、A/B、会话回放?
能,都在开源版本里。会话回放默认关闭,在项目设置里打开。见 全埋点与热力图、A/B 实验、会话回放。
有官方 SaaS 吗?
没有。evstats 只提供自己部署的软件。
支持小程序、App 吗?
官方不维护 iOS、Android、小程序 SDK。按 HTTP 协议 可以自己发,字段和 Web SDK 一样。
能做用户分群、推送吗?
不能。evstats 不做身份合并、标签、分群推送,也不发邮件、短信。
数据与部署
「演示项目」里的数据是哪来的?
首次引导的第二步选了「创建演示项目」,服务端就按程序里固定的剧本当场生成:一个虚构的在线表单产品、近 35 天约 1 万条事件,不会往外发任何请求。它和你自己的项目互不影响,不需要时在「系统 → 项目」里停用,之后不会再建。见 创建演示项目。
数据在哪?
在你自己的 ClickHouse 里。账号、项目、配置也在同一个 ClickHouse,没有第二个数据库。
上报先写到哪?
先写入 Redis 队列,写入成功就给 SDK 返回成功;再由后台批量写入 ClickHouse,写入成功才从队列里确认。所以进程崩溃也不会丢已经返回成功的事件。
多台机器一起接上报会不会乱?
不会。所有进程写同一个 Redis 队列,写进 ClickHouse 成功才确认;同一个项目总是写进同一个分片。负载均衡不需要会话粘滞。见 多节点与分片。
IP 会不会传到外面做解析?
不会。IP 库只按你填的地址下载一次,之后在本机内存里查。
IP 库文件在安装包里吗?
不在。在「系统配置 → IP 库」里填下载地址,界面上有推荐地址。不填也能收数,只是没有地域。
升级要不要跑脚本?
不要。换程序启动,缺表建表、缺列加列,改了什么记在「关于」页。只有修复聚合、给新维度补历史这类例外,更新日志会给出语句。见 升级。
能不能挂在子路径下,例如 /evstats/?
不能。请用独立的域名或子域名。
能改项目时区吗?
不能,创建时选定。日期在入库时就按项目时区算好了。
接入
装了 SDK 为什么没数据?
按 接入检查 的顺序查,先看 /sa 的响应码。
匿名和登录用户为什么对不上?
本期不自动合并。登录前的匿名 ID 和登录后的用户 ID 是两个 distinct_id。见 接入概览。
会不会重复计数?
SDK 在网络失败时会重试,极少数情况下同一条事件可能入库两次。本期查询不按 event_id 去重。
使用
给 ChatGPT 或别的 Agent 用哪把钥匙?
接口密钥(evs_xxx),不是写入密钥。见 给外部 Agent 用。
AI 会不会编数字?
它只能调用统计查询,不能写 SQL。每个数字都能在对话里的查询卡片中找到,也能「在 Stats 打开」对照原图。
能不能显示在我们自己的后台?
可以,用 OpenAPI。权限跟用户走,撤权立即生效。看板本身不能分享给未登录的人,也不能嵌入 iframe。
文档里的接口为什么没有登录?
登录、引导、系统管理这些是仪表盘自己用的接口,不属于对外接口,也不承诺兼容。对外只有只读的 /api/v1。
能不能导出?
后台每张表都能导出 CSV(最多 10 万行)。OpenAPI 返回 JSON,没有 CSV。
登录态存在哪?
HttpOnly Cookie,页面脚本读不到。会话本身在 Redis 里。
为什么周 UV 不等于每天 UV 相加?
因为同一个人在一周里来了几天,只算一个人。把每天的 UV 相加会重复计数。见 指标口径。
支持哪些语言的界面?
简体中文和英文。