使用 Wrangler 构建请求分析管道。
通过 Basin Pipelines 将请求记录到 Cloudflare Worker,以 Apache Iceberg 表的形式存储到 Basin Catalog,再用 Basin SQL 按路径统计请求。
Worker → Basin Pipelines → Basin Catalog → Basin SQL
- 已启用 Workers Paid 和 R2 的 Cloudflare 账户。可用性和用量详情请参阅 Basin Pipelines 定价 和 Basin SQL 定价。
- Node.js 和 npm ↗。Worker 起始模板会为你安装 Wrangler。
- 具有 Admin Read & Write 权限的 R2 Account API token。从 R2 object storage(R2 对象存储) > Overview(概览) > Manage API tokens(管理 API 令牌) 创建。请妥善保管该令牌。setup 命令会要求提供它,Basin SQL 也使用同一令牌。
-
使用 C3 ↗ 创建 JavaScript Hello World Worker:
npm create cloudflare@latest -- hello-world-pipeline --type=hello-world --lang=js --no-deploy --no-git --accept-defaultsyarn create cloudflare hello-world-pipeline --type=hello-world --lang=js --no-deploy --no-git --accept-defaultspnpm create cloudflare@latest hello-world-pipeline --type=hello-world --lang=js --no-deploy --no-git --accept-defaults进入项目目录:
cd hello-world-pipeline起始模板会创建
src/index.js和wrangler.jsonc。如果下一步 Wrangler 要求身份验证,请登录:npx wrangler loginyarn wrangler loginpnpm wrangler login -
使用交互式设置创建 stream、sink 和 pipeline:
npx wrangler basin pipelines setup --name request_eventsyarn wrangler basin pipelines setup --name request_eventspnpm wrangler basin pipelines setup --name request_events在设置提示中:
- 关闭 HTTP 端点。此 Worker 通过绑定发送事件。
- 以交互方式构建架构,包含一个名为
path的必填string字段。 - 选择 Data Catalog (Iceberg) 和 Advanced。输入唯一的 R2 存储桶名称,例如
request-events-<UNIQUE_SUFFIX>。使用命名空间default和表request_events。 - 输入你的 R2 Account API token。接受默认压缩和 100 MB 文件大小,然后将滚动间隔设为 60 秒。
- 确认资源创建,并为管道 SQL 选择 Simple ingestion。
保存设置输出中显示的存储桶名称和 stream ID。Worker 绑定使用的是 stream ID,而不是 pipeline ID。如果错过了,请列出 stream 并查找
request_events_stream:npx wrangler basin pipelines streams listyarn wrangler basin pipelines streams listpnpm wrangler basin pipelines streams list -
在
wrangler.jsonc根对象中添加pipelines属性。将<STREAM_ID>替换为设置中的 stream ID,并保留其他已生成的属性:{ "pipelines": [ { "binding": "EVENTS", "stream": "<STREAM_ID>" } ] }[[pipelines]] binding = "EVENTS" stream = "<STREAM_ID>"在
src/index.js中,于现有响应之前添加一行。Worker 仍会返回Hello World!:src/index.jsjs export default { async fetch(request, env, ctx) { await env.EVENTS.send([{ path: new URL(request.url).pathname }]); return new Response("Hello World!"); }, };src/index.tsts export default { async fetch(request, env, ctx) { await env.EVENTS.send([{ path: new URL(request.url).pathname }]); return new Response("Hello World!"); }, };绑定会处理摄取身份验证。不要将 R2 API 令牌添加到 Worker 或
wrangler.jsonc。 -
部署 Worker:
npx wrangler deployyarn wrangler deploypnpm wrangler deploy打开 Wrangler 打印的 URL,访问
/和/example。两个路径都会显示Hello World!,并且每次请求都会记录其路径。刷新/可再记录一次请求。 -
获取与 R2 存储桶关联的仓库名称:
npx wrangler basin catalog get <YOUR_BUCKET>yarn wrangler basin catalog get <YOUR_BUCKET>pnpm wrangler basin catalog get <YOUR_BUCKET>在终端会话中设置令牌,然后按路径统计请求:
export WRANGLER_BASIN_SQL_AUTH_TOKEN="<YOUR_R2_ACCOUNT_API_TOKEN>"npx wrangler basin sql query "<WAREHOUSE_NAME>" "SELECT path, COUNT(*) AS requests FROM default.request_events GROUP BY path ORDER BY requests DESC"yarn wrangler basin sql query "<WAREHOUSE_NAME>" "SELECT path, COUNT(*) AS requests FROM default.request_events GROUP BY path ORDER BY requests DESC"pnpm wrangler basin sql query "<WAREHOUSE_NAME>" "SELECT path, COUNT(*) AS requests FROM default.request_events GROUP BY path ORDER BY requests DESC"将
<WAREHOUSE_NAME>替换为 catalog 命令返回的值。结果应包含/和/example及其请求计数。其他路径(例如/favicon.ico)也可能出现。如果找不到表或没有返回行,请等待几分钟以便写入第一个文件,然后再次运行查询。
首次查询成功后,可以为事件添加时间戳、请求方法或国家/地区。更多详情请参阅 Basin Pipelines 快速入门、Basin Catalog 快速入门、Basin SQL 快速入门 和 Workers 绑定。