Spend Management 上线后,Workers 与 Durable Objects 的预算告警怎么配合用量口径
Spend Management 的告警与硬限额都按“当前计费周期内累计估算支出”评估,不按请求数或 CPU 时间。要让它和用量口径配合,需把预算换算成金额、按订阅起始日而非自然月切分窗口、给异步暂停留出缓冲,并把 Workers 与 Durable Objects 当作两个独立控制面分别配置。计量管线先按约 1 分钟和约 5 分钟两级聚合再进入评级,仪表盘成本展示延迟在 10 分钟内,但限额执行是异步下发的。
- 告警阈值和硬限额的单位是计费周期累计支出(threshold_cents,美分),不是请求数、CPU 毫秒或存储操作数。
- 计费周期从付费订阅开始日算起,10 月 10 日订阅通常对应 10 月 10 日至 11 月 10 日,不是自然月。
- 暂停只针对产生费用的客户代码调用:Workers 中 Cron Triggers 与 Queue consumer 调用
- Workers 与 Durable Objects 需要分别启用和配置,一个产品的限额不覆盖另一个。
Spend Management 的告警和硬限额不看你发了多少请求、用了多少 CPU 毫秒,也不看 Durable Objects 做了多少次存储操作。它评估的是当前计费周期内累计的估算支出。所以要让它和你的用量口径配合,真正要做的是三件事:把预算换算成金额阈值、按订阅周期而不是自然月切分窗口、给异步暂停留出缓冲;另外,Workers 与 Durable Objects 必须分别配置。以下结论均来自 Cloudflare 2026 年 11 月 13 日的发布说明,该功能目前处于 Beta,字段与行为可能变化。
一、告警的评估单位是周期累计支出#
在仪表盘的 Manage Account > Billing > Spend limits 里为某个产品启用控制后,需要填写三项:支出限额、通知邮箱、一个或多个告警阈值。配置了邮箱后,当评估出的支出达到任一阈值或达到限额时,Cloudflare 会发邮件;达到限额时,会执行阻断策略,该产品自动暂停。API 示例里的字段是 threshold_cents,值为 10000,即 100 美元——单位是美分,填错两个数量级是这类配置最常见的错误。
评级环节有一个容易被忽略的细节:它按累计用量计价,先扣掉套餐包含的额度,再对超出部分计费,而不是对每个请求单独取整后累加。所以“小额高频请求导致账单虚高”并不是这套口径下的问题,你不需要为此调整告警阈值。
计费周期不是自然月
博客明确说明:计费周期从付费订阅开始时算起,而不是从部署 Worker 或创建支出上限时算起。10 月 10 日开始的订阅,周期一般是 10 月 10 日到 11 月 10 日。这意味着如果你的团队按自然月做预算表,累计支出不会在每月 1 日归零;如果订阅日落在月中,一个自然月会跨两个计费周期,仪表盘上的累计值会先重置再重新累加。排阈值时应以订阅日为锚点,否则告警会在你预期之外的时间点触发。
二、Workers 和 Durable Objects 是两个独立控制面#
Spend Management 按产品维度启用和配置:每个产品有自己的限额、阈值和通知邮箱。触发限额时,“该产品的新调用被拒绝”。因此给 Workers 设一个 100 美元的限额,并不会约束 Durable Objects 的支出;两者需要分别估算规模、分别配置。博客只给出了 "product_id": "workers" 这一示例,Durable Objects 对应的 product_id 取值本次材料未提供,调用 API 前需在开发者文档中核实。
三、排阈值时要把计量链路算进去#
博客披露了支出数据的生成路径,这决定了告警的时效边界:
- 第一级聚合:各产品的计量解析器把原始事件转成用量度量,并在靠近源头的位置按约 1 分钟窗口合并。
- 第二级聚合:另一个服务按相同分组规则,在约 5 分钟窗口上合并第一级结果,同时归档,形成可用于后续分析与对账的持久数据集。
- Usage Engine:按账户分区,把度量翻译成含账户、窗口、指标、数量的标准化用量记录,并就地维护该账户的累计用量与包含额度。
- Rating Engine:结合用量记录、订阅信息与定价规则(费率、包含额度、取整规则)算出累计支出。用量流和订阅流是独立的、可能乱序到达;用量先到而订阅信息未到时,会挂起等待而不是当作免费。
- 策略评估与报告:判断是否触达警告或阻断阈值,更新仪表盘并发送邮件。
- 异步执行:评级引擎不在请求路径上,不直接拒绝请求;策略服务把上限下发给运行时配置服务后生效。
由此可以得出两条实践建议。第一,仪表盘展示的成本延迟在 10 分钟以内,但这只是展示层;链路前段还有聚合窗口,告警本质上是对已发生支出的近实时观察,不是事前拦截。第二,最高告警阈值和硬限额之间要留余量,用于覆盖“已经发生但尚未进入评估”的那部分支出和异步下发的时间差。余量多大取决于你的峰值支出速率,官方材料未给出保证值,需按峰值流量乘单价自行估算,这部分属于推断而非文档承诺。
四、暂停时停什么、不停什么#
这一点直接影响故障设计:上限生效后,Cloudflare 只暂停会产生费用的客户代码调用。在 Workers 中,Cron Triggers 和 Queue consumer 的调用会被暂停,而静态资源继续对外提供。也就是说,页面可能照常打开,但定时任务和队列消费停了。这两种调用被暂停后,任务是排队等待还是被丢弃,本次材料未说明,需核实。
恢复服务有三条路径:把限额提高到当前周期累计支出之上;禁用或删除阻断策略;等下一个计费周期,让现有阻断自然过期。前两条是应急手段,第三条意味着一次未处理的中断可能持续到周期结束。
五、配置示例#
下面这条请求来自博客原文示例,未在本环境执行;example.com 与 YOUR_... 均为占位,需替换为真实账户与令牌。threshold_cents: 10000 对应 100 美元。
curl --fail-with-body --request POST \
"https://api.cloudflare.com/client/v4/accounts/${CLOUDFLARE_ACCOUNT_ID}/billing/spend-policies" \
--header "Authorization: Bearer ${CLOUDFLARE_API_TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"name": "Workers spending cap",
"product_id": "workers",
"enabled": true,
"threshold_cents": 10000,
"action": "usage_block",
"notification_email": "me@example.com"
}'
CLI 侧在同一套 API 上提供了 create、list、get、update、delete,以及 audit list 和 activity list。审计接口能回答“谁在什么时候改了限额、上限何时被触达”,适合接入变更流程,而不是只靠邮件通知。以下命令同样未执行:
cf billing spend-policies list
cf billing spend-policies audit list
需要说明的是:仪表盘支持配置一个或多个告警阈值,但 API 示例中只出现了单个 threshold_cents 字段。多阈值在 API 中如何表达,本次材料未覆盖,需查阅开发者文档确认后再写进自动化脚本。
六、别和 AI Gateway 的预算混为一谈#
博客建议把 Spend Management 与 AI Gateway 的支出限制配合使用。两者口径不同:AI Gateway 的预算是按用户、按模型的,作用于经过网关的请求;Spend Management 是账户级、按产品汇总的支出上限。经网关的推理请求会同时受两套规则约束,任何一方都不能替代另一方——AI Gateway 限住的是单个用户或模型的用量,限不住 Workers 本身的计算支出。
七、落地核对清单#
- 记录订阅起始日,按订阅周期而非自然月推算窗口,并同步给做预算表的同事。
- Workers 与 Durable Objects 分别设限额和阈值,不要假设一个产品能兜住另一个。
- 至少在最高阈值与硬限额之间留出一段余量,余量按峰值支出速率估算。
- 确认暂停后 Cron 与 Queue 的行为,为定时任务设计幂等与补偿逻辑,避免恢复后重复执行。
- 用 API 或 CLI 管理策略并纳入版本控制,定期核对审计日志。
- 邮件通知之外是否需要更快的响应通道,材料未提供 webhook 类机制,待核实。
边界提醒:该功能处于 Beta,仅面向按量付费(PayGo)客户,目前覆盖 Workers 与 Durable Objects,其他产品“即将支持”。上述计费周期示例、暂停范围与恢复路径以发布说明为准;product_id 取值、多阈值 API 表达、Durable Objects 在暂停后的具体行为,均需以官方开发者文档核实后再用于生产配置。来源:Introducing Spend Management: Spending limits and alerts for Cloudflare(2026 年 11 月 13 日)。
参考来源
以上为本文写作时的参考资料,引用观点以原文为准。