跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

CLI

最后更新 查看 MarkdownAgent 设置

使用 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 也使用同一令牌。

创建并查询请求数据

  1. 使用 C3 ↗ 创建 JavaScript Hello World Worker:

    npm 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 login
  2. 使用交互式设置创建 stream、sink 和 pipeline:

    npx 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 list
  3. 在 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。

  4. 部署 Worker:

    npx wrangler deploy

    打开 Wrangler 打印的 URL,访问 / 和 /example。两个路径都会显示 Hello World!,并且每次请求都会记录其路径。刷新 / 可再记录一次请求。

  5. 获取与 R2 存储桶关联的仓库名称:

    npx 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"

    将 <WAREHOUSE_NAME> 替换为 catalog 命令返回的值。结果应包含 / 和 /example 及其请求计数。其他路径(例如 /favicon.ico)也可能出现。如果找不到表或没有返回行,请等待几分钟以便写入第一个文件,然后再次运行查询。

后续步骤

首次查询成功后,可以为事件添加时间戳、请求方法或国家/地区。更多详情请参阅 Basin Pipelines 快速入门、Basin Catalog 快速入门、Basin SQL 快速入门 和 Workers 绑定。

这篇文档对您有帮助吗?