限制与上限
分散在各处的数字上限集中在这一页。超过时接口返回 40001（参数）、41301（大小）或 42901（频率），message 里写明上限。
采集
| 项 | 上限 |
|---|---|
| 请求体 | 压缩前 1MB；gzip 解压后同样不超过 1MB，超过返回 41301 |
| 每批事件 | 100 条 |
单条事件的 properties | 16KB；键最多 100 个，键名最长 64，嵌套最多 3 层 |
| 客户端时钟 | 比服务器快超过 2 小时时改用服务器时间；比服务器早 7 天以上的事件丢弃 |
| 域名白名单、黑名单 | 各 200 条 |
| 排除 IP | 50 条 |
| 遮罩选择器 | 50 条 |
| 全埋点元素文本 | 100 字 |
| 回放单块 | 2MB |
| 采集队列积压 | ingest.stream_max，默认 100 万条，超过返回 42901 |
查询跨度
每个模块能查的最长日期跨度：
| 模块 | 最长 |
|---|---|
| 数据概览、数据汇总、趋势分析 | 366 天（小时粒度 7 天） |
| 地域、来源网站、渠道、设备、受访页面、结构化页面 | 366 天 |
| 事件统计 | 366 天 |
| 活跃用户 | 366 天（活跃天数分布 90 天） |
| 实时访问 | 180 分钟（15 / 30 / 60 / 180） |
| 入口页、退出页、站内搜索、站外搜索 | 31 天 |
| 事件日志、自定义分析、路径、热力图、会话回放列表 | 31 天 |
| 新老访客、忠诚度、流失、留存、回流与沉默 | 90 天 |
| 漏斗、归因、A/B 实验 | 90 天 |
分析参数
| 项 | 上限 |
|---|---|
| 漏斗步骤 | 2～8 步 |
漏斗窗口 window_hours | 1～168 小时，默认 24 |
| 结构化页面深度 | 1～3 段 |
事件日志 limit | 后台 1～200，默认 50；OpenAPI 1～100，默认 20 |
| 用户查找 | 最近 90 天，最多 50 条 |
| 用户画像时间线 | 最近 90 天，最多 200 条 |
| 实时访问的最近访问列表 | 50 条 |
| 路径 | 30 分钟内的下一步，Top 10 |
| 筛选值自动补全 | 前 50 个 |
会话回放列表 limit | 1～100，默认 50 |
| 自定义 SQL | 默认 200 行，最多 2000 行；30 秒 |
| CSV 导出 | 10 万行 |
| 查询超时 | 普通统计 15 秒；漏斗、留存、路径、归因、自定义 SQL 30 秒 |
Agent
| 项 | 上限 |
|---|---|
| 单次查询交给模型的结果 | 200 行，超过时截断并注明 |
| 一次提问的工具调用 | 8 轮 |
| 带进模型的历史 | 20 条消息 |
| 一次提问的时长 | 120 秒 |
| 每人每天的提问 | ai.user_daily_limit，默认 200，0 不限 |
| 演示用户每人每天的提问 | demo.agent_daily_limit，默认 20 |
OpenAPI 与密钥
| 项 | 上限 |
|---|---|
| 每人的接口密钥 | 10 把 |
| 每把密钥的调用频率 | 全集群 60 次 / 分钟 |
看板、书签、实验
| 项 | 上限 |
|---|---|
| 每人每个项目的看板 | 20 个 |
| 每个看板的卡片 | 24 张 |
| 看板内容（卡片配置） | 64KB |
| 卡片尺寸 | 12 栏栅格；宽 3～12 栏，高 2～8 行 |
| 每人每个项目的书签 | 50 个 |
| 看板、书签名称 | 1～40 字 |
| 每个 A/B 实验的变体 | 2～8 个 |
| 每个项目同时进行中的实验 | 50 个 |
账号与安全
| 项 | 上限 |
|---|---|
| 用户名 | 3～32 个字符 |
| 密码 | 不限长度、不限字符；空格会去掉 |
| 登录失败 | 同一用户名、同一 IP 10 分钟内 10 次，之后 42901 |
| 验证码 | 2 分钟有效，只能用一次 |
| 重置密码邮件 | 每人每小时 3 封；链接 1 小时有效、只能用一次 |
| 登录会话 | 7 天，使用中自动续期 |
| 热力图叠加令牌 | 10 分钟 |
登录页演示提示 demo.hint | 200 字 |
项目与保留
| 项 | 范围 / 默认 |
|---|---|
项目标识 project_code | [a-z][a-z0-9_-]{1,31} |
| 明细保留天数 | 1～3650，默认 365 |
聚合保留天数 agg.retain_days | 默认 400 |
操作日志保留天数 audit.retain_days | 默认 400 |
回放保留天数 replay.retain_days | 默认 15 |
| 回放抽样比例 | 1～100，默认 10 |
| 归因回看天数 | 默认 30，最大 90 |
运行
| 项 | 值 |
|---|---|
| 优雅退出 | 最多 15 秒 |
| 攒批 | ingest.batch_size 1000 条、ingest.max_batch_bytes 4MB、ingest.flush_ms 200ms，先到先写 |
| 统计结果缓存 | stat.cache_ttl_sec 60 秒；实时 stat.cache_ttl_realtime_sec 5 秒 |
| SDK 配置缓存 | 5 分钟 |
| IP 库文件 | 最大 80MB，下载超时 60 秒 |
| 在线人数 | 近 5 分钟出现过的人 |
SDK
| 项 | Web | Go / Java |
|---|---|---|
| 本地队列 | localStorage 200 条，超出丢最旧 | 内存 1000 条，超出丢最旧 |
| 发送间隔 | 300ms | 500ms |
| 单批 | 20 条 | 100 条 |
| 重试 | 200ms 起退避，最多 5 次 | 同左 |
| 压缩 | 单批超过 32KB 用 gzip | |
| 核心体积 | gzip 后小于 10KB（不含回放） |
性能
性能数字只写测过的基线，并写明测试环境。三档测试环境：
| 档位 | 环境 |
|---|---|
| 单机最小 | 1 台 2 核 4GB：ClickHouse、Redis、evstats 同机 |
| 单机标准 | ClickHouse 8 核 32GB SSD；evstats 与 Redis 另一台 4 核 8GB |
| 多节点 | 3 台 evstats（各 4 核 8GB）+ 共用 Redis + 2 个 ClickHouse 分片（各 8 核 32GB） |
各档的吞吐、延迟和查询耗时实测之后公布在这里和更新日志里。之后每次发版都在同样的环境复测，退化超过 10% 不发布。