SuperAPI AI 工具集

analytics-engine

数据与分析

查看项目

更新于 10-16 02:33

技能介绍

用途:在 Cloudflare Workers 中写入并查询大规模高基数事件数据,适合用户行为追踪、计费与用量指标、多租户分析、A/B 测试指标和 API 用量统计。

主要能力:数据点由三类字段组成——doubles(数值指标,最多 20 个)、blobs(文本标签,最多 20 个)、indexes(分组键,1 个,最大 96 字节)。写入使用 env.DATASET.writeDataPoint({ doubles, blobs, indexes }),为非阻塞调用,不要 await。查询通过 REST SQL API:https://api.cloudflare.com/client/v4/accounts/{account_id}/analytics_engine/sql,字段按写入顺序自动编号为 double1、blob1、index1 等,可用 AS 别名。

使用方式:先执行 wrangler analytics-engine create my-dataset 创建数据集,再在 wrangler.jsonc 的 analytics_engine_datasets 中配置 binding 与 dataset。TypeScript 中声明 Env 接口,如 USER_EVENTS: AnalyticsEngineDataset。

限制:每次 Worker 调用最多写入 250 个数据点;blobs 总量每数据点 16 KB;索引 96 字节;免费额度为每天 10 万次写入、1 万次查询(尚未强制执行);查询平均约 100ms、p99 约 300ms;数据保留 3 个月;写入与查询之间存在最终一致性延迟;无本地模拟,测试需采用 mock 策略。

适用场景:用户会话追踪、错误追踪、收入事件、按客户或端点统计 API 用量等。设计时应先确定索引键,保持字段顺序一致,并注意高基数索引对查询性能的影响。