Cloudflare AI Gateway 日志配置应从团队需要的证据和不应保留的内容开始。仪表盘让请求可见的同时，也可能创建新的提示词、响应和元数据存储。正确设置取决于运维用途，以及账户当前适用的日志契约。
先确定网关使用当前 Workers Logs 安排还是 Legacy Logs，再有意识地配置收集与载荷存储。通过带合成标记的真实请求路径测试，检查产生的记录。在适当时保留有用运维元数据，但不要假设关闭载荷存储就能从所有其他系统删除数据。
设想客服助手的提示词包含客户往来。工程师需要诊断供应商故障并归因用量，却未必需要将全部往来复制到通用诊断存储。这是配置和证据问题，并不意味着需要放弃可观察性。
本文关注建议的运维配置，不提供法律合规认证，也不假定每个账户具有相同价格、保留和导出安排。
Cloudflare AI Gateway 日志配置取决于资格
当前 AI Gateway 日志文档 根据客户创建首个网关的时间进行区分。首个网关在 2026 年 9 月 24 日或之后创建的客户，采用 Workers Logs 价格与保留安排；更早的客户使用 Legacy Logs。应核实正在配置的账户适用哪种资格。
不要从旧文章抄取保留期或日志额度，再应用到所有部署。记录适用服务安排、选定设置与检查日期。账户或日志架构变化时应重新核实。
同一文档将完整日志条目的收集，与请求和响应载荷的存储分开。这种区别比简单询问日志开启或关闭更精确。
| 决策 | 需要确定的问题 |
|---|---|
| 日志安排 | 此账户适用哪种当前或旧契约？ |
| 完整条目收集 | 此类请求是否应存在诊断记录？ |
| 载荷存储 | 是否必须保留提示词和响应内容？ |
| 访问 | 谁可以检查或导出记录？ |
| 保留 | 主要副本和导出副本何时过期？ |
先定义事故问题
写下运维人员必须回答的问题：哪个负载失败？使用了哪条供应商和模型路径？应用是否重试？用户停止等待前是否返回响应？目标任务是否仍未解决？
许多问题可通过有限元数据和应用操作编号回答，不一定需要完整提示词。反过来，内容质量调查可能需要经过明确控制的样本，通用请求元数据无法解释这种问题。
将这些用途分开。客服应用常规诊断可以遵循一种收集策略，获准调查则使用另一种经过复核的证据流程。不要仅因某天可能有助复现缺陷，就永久保留每位客户的文字。
我们已有的 AI Gateway 指南 介绍更广泛的代理与成本控制角色。本文配置工作的重点，是确定实际存在什么证据，并证明选定收集行为。
分别配置完整条目与载荷控制
Cloudflare 文档以 cf-aig-collect-log 控制完整条目收集，以 cf-aig-collect-log-payload 控制请求和响应载荷存储。将载荷控制设为 false，可以保留元数据而不存储原始正文；关闭完整条目则会抑制包括元数据在内的整个条目。应用前应阅读当前标头语义。
以下只是示意性标头策略，并非完整请求，也不能证明部署结果：
1cf-aig-collect-log-payload: false
在可信应用组件中实施策略。不可信调用者不应通过注入任意网关控制标头，改变组织证据策略。确定哪些标头由服务器转发、设置或移除。
不要根据单次成功请求推断默认值。分别验证网关级设置与逐请求覆盖路径。适用于主模型路径的配置，经过回退或另一客户端时仍可能表现不同。
记录实际生效策略
对应用侧配置进行版本管理，并记录相关网关设置。说明哪些请求类别保留载荷，哪些只保留元数据，哪些完全抑制收集。
开发者添加另一模型集成时，复核应包含其日志路径。否则，应用会积累多条保留行为不同的路径，而团队仍以为只有一种全局策略。
不要让元数据变成另一种载荷
不透明任务和请求编号可以将网关证据与应用记录连接起来。客服案例标识符可能足以按现有访问模型定位来源。把消息主题或客户邮箱复制到元数据字段，会破坏排除提示词正文的初衷。
定义允许的元数据模式。除了字段名，也检查值。如果应用用用户文字填充，名为 label 的字段仍会包含个人或机密内容。
| 元数据选择 | 运维用途 | 复核关注点 |
|---|---|---|
| 不透明负载标识符 | 将用量归因到应用功能 | 避免嵌入客户内容 |
| 操作编号 | 将事故关联到任务状态 | 关联记录仍受访问控制 |
| 配置版本 | 复现实际生效路径 | 值中不能包含密钥 |
| 故障类别 | 对可处理问题分组 | 避免含来源内容的原始异常载荷 |
保持应用与网关编号足够一致，以支持调查。运维人员应无需在工具间复制整个提示词，也无需给所有工程师客户系统访问权，就能追踪故障。
用合成标记验证收集
发送包含独特标记的非敏感测试请求。检查适用日志目标，确认在预期策略下，标记是否出现在载荷存储、元数据、导出或相关应用日志中。
测试正常响应、上游错误，以及应用使用的回退路径。错误处理经常会在正常收集路径之外，将请求正文复制到诊断字段。
| 测试 | 仅元数据策略下的预期证据 |
|---|---|
| 正常推理 | 有用请求元数据，不含合成正文标记 |
| 供应商错误 | 故障类别和关联编号，不复制载荷 |
| 应用重试 | 可以关联各次尝试，不在标签中重复内容 |
| 未授权网关请求 | 按网关访问策略拒绝 |
| 导出或下游日志目标 | 仍遵循商定内容与保留策略 |
Cloudflare 的认证网关文档 是该访问控制的依据。检查部署中的实际凭据与路径，不要假设日志设置同时保护端点。
复核导出和其他存储
网关抑制载荷，并不能证明应用、模型供应商或外部可观察性服务完全不保留内容。绘制真实数据路径，按各存储自己的契约复核。
如果导出日志，记录谁能读取目标、这些副本何时过期。从某项服务删除记录，不能证明更早导出也已移除。运维手册应说明哪个系统负责哪种证据。
也复核跟踪、异常追踪器和客服截图。团队可能正确配置网关，却仍将客户提示词粘贴到更广泛群体可见的工单中。
常规回归测试使用合成案例。确需真实内容调查缺陷时，应确立具体收集目的与受控访问，而不是不留记录地改变通用策略。
为有用证据及其维护编制预算
实施成本包括数据路径复核、请求策略接线、元数据模式、权限配置与验证。持续成本取决于适用日志安排、数量及下游存储，因此估算前应核实账户当前费率。
要求 GBP 方案报价，标识网关安排与交付测试。只配置设置，与重建跨多条模型路径和导出目标的应用日志，是不同任务。
交接应包含实际策略、责任归属、合成测试结果，以及调查证据缺失的流程。列出触发重新验证的配置变化，尤其是新客户端、路径或日志目标。
我们可以通过范围明确的 AI 集成试点 复核这一边界。请提供账户资格、模型路径、当前日志目标和事故问题，索取网关日志评估 。让可观察性真正有用，而不是仅因默认允许就收集内容。
常见问题
所有 AI Gateway 账户采用相同日志安排吗？ 不是。当前文档区分首个网关在 2026 年 9 月 24 日或之后创建的客户与更早客户。依赖价格或保留假设前，核实适用 Workers Logs 还是 Legacy Logs。
可以保留元数据而不保留提示词和响应正文吗？ 适当配置时，文档规定的载荷收集控制支持仅元数据条目。应验证实际网关和逐请求策略，并检查真实日志目标中的测试结果。
两个收集标头有什么区别？ 完整条目控制决定是否收集日志条目，载荷控制决定是否存储原始请求和响应正文，同时可以保留元数据。关闭完整条目也会删除其元数据，因此应根据所需证据选择。
抑制载荷意味着没有服务存储数据吗？ 不是。其他应用日志、供应商、导出和可观察性工具有自己的行为与契约。应复核完整数据路径，不要将单个网关设置视为普遍保留保证。
不使用客户数据，如何测试日志？ 在非敏感请求中使用合成标记，检查相关记录与导出。包含正常结果、错误、重试和回退路径，并确认元数据没有间接包含标记。
应该允许客户端选择日志策略吗？ 只有有意授予这种权限时才可以。在可信服务器组件中实施组织策略，明确接受或覆盖哪些控制标头。普通调用者不应悄悄改变证据策略。
评估应该交付什么？ 识别适用契约、数据存储、实际收集策略、访问负责人和保留决策。包含合成验证结果，以及检查新模型路径或日志目标的可重复流程。