Workers for Platforms 为您提供日志和分析,可用于与最终用户共享数据。
使用 Workers for Platforms 访问日志有几种方式。它们的区别在于 Cloudflare 为您运行多少日志堆栈:
- Workers Logs — Cloudflare 存储并索引您的日志,您通过 API 查询。无需再运行其他内容。这是大多数平台的最佳起点。
- Logpush — Cloudflare 将日志投递到您拥有并管理的存储目标。
- Tail Workers — Cloudflare 实时将日志流式传输到 Worker,由您决定如何处理。
Workers Logs 会自动将用户 Worker 的日志存储到您的 Cloudflare 账户中,您可以通过 Query Builder 或 Workers Observability API 进行查询。由于它是完全托管的,您可以在自己的仪表板中展示按用户划分的日志视图,而无需自建数据库、配置 Logpush 或部署 Tail Worker。
在将脚本上传到分派命名空间时,在元数据中包含 observability 设置,即可为用户 Worker 启用 Workers Logs:
{
"main_module": "index.js",
"observability": {
"enabled": true,
"logs": {
"enabled": true,
"invocation_logs": true,
"head_sampling_rate": 1
}
}
}由于您控制上传元数据,因此可以决定是否为每个用户 Worker 启用日志记录。将 head_sampling_rate 设为 0 到 1 之间的值以记录一定比例的请求,或将 observability.enabled 设为 false 以关闭收集。
Workers Logs 存储在 cloudflare-workers 数据集中。当您代表最终用户查询 Workers Observability API 时,请将每次查询限定到特定用户 Worker,以免一个租户读取另一个租户的遥测数据。请过滤 dataset(设为 cloudflare-workers)和 $metadata.service(用户 Worker 的脚本名称)。
请在服务器上使用您控制的脚本名称应用这些过滤器,而不是接受来自浏览器的脚本名称、数据集或原始过滤器。即使查询由最终用户输入(例如搜索词或时间范围)触发,也能保持每个用户的日志相互隔离。
Workers Trace Events logpush 用于获取原始 Workers 执行日志。更多信息请参阅 Logpush。
可以为一整个分派命名空间或单个用户 Worker 启用 Logpush。要捕获分派命名空间中所有用户 Worker 的日志:
- 创建 Logpush 作业。
- 在您的分派 Worker 上启用 日志记录。
在分派 Worker 上启用日志记录会收集分派 Worker 以及分派命名空间中任何用户 Worker 的日志。添加到分派命名空间的所有新 Worker 会自动收集日志。要为单个用户 Worker 而非整个分派命名空间启用日志记录,请跳过步骤 1,并在用户 Worker 上完成步骤 2。
所有日志都会转发到您为账户设置的 Logpush 作业。可以在 Outcome 或 Script Name 字段上使用 Logpush 筛选条件,以包含或排除特定值,或将日志发送到不同目标。
Tail Worker 接收有关其他 Workers(称为 producer Workers)执行情况的信息,例如 HTTP 状态、传递给 console.log() 的数据或未捕获的异常。
如果您希望在日志离开 Cloudflare 之前对其进行格式化、接收 diagnostics channel 事件,或实时获取日志,请使用 Tail Workers 而非 Logpush。
要从用户 Worker 收集日志,请将 Tail Worker 配置 直接添加到该用户 Worker。
有两种方式可以查看您的 Workers for Platforms 分析。
Workers Analytics Engine 可与 Workers for Platforms 配合使用,向最终用户提供分析。它可用于公开与 Workers 调用相关的事件或自定义用户定义事件。平台可以按 script tag 写入/查询事件,以获取用户使用情况的聚合数据。
使用 Cloudflare 的 GraphQL Analytics API 获取与您的 Dispatch Namespaces 相关的指标。在 workersInvocationsAdaptive 节点中使用 dispatchNamespaceName 维度按 namespace 查询使用情况。
要显示单个用户 Worker 的指标,请按该用户 Worker 的 scriptName 过滤 workersInvocationsAdaptive。这会返回请求数、错误数和 CPU 时间分位数,且不要求启用 Workers Logs,因此即使关闭了日志收集,您也可以显示按用户划分的指标。
query UserWorkerMetrics($accountTag: string!, $scriptName: string!, $start: Time!, $end: Time!) {
viewer {
accounts(filter: { accountTag: $accountTag }) {
workersInvocationsAdaptive(
limit: 1
filter: { scriptName: $scriptName, datetime_geq: $start, datetime_leq: $end }
) {
sum {
requests
errors
}
quantiles {
cpuTimeP50
cpuTimeP99
}
}
}
}
}