日志记录

日志记录是应用开发的基本构建块。日志在开发的早期阶段提供洞察，并且通常对于理解生产中发生的问题至关重要。

您的 AI 网关仪表板显示单个请求的日志，包括用户提示、模型响应、提供商、时间戳、请求状态、令牌使用量、成本和持续时间。这些日志会持久化，为您提供按首选持续时间存储它们的灵活性，并对有价值的请求数据做更多事情。

默认情况下，每个网关最多可以存储 1000 万条日志。您可以在网关设置中为每个网关自定义此限制，以符合您的特定要求。如果达到存储限制，新日志将停止保存。要继续保存日志，您必须删除较旧的日志以为新日志释放空间。 要了解更多关于您的计划限制，请参阅限制。

我们建议在存储日志时使用已验证的网关，以防止未经授权的访问，并防范可能增加日志存储使用量并使您难以找到所需数据的无效请求。了解更多关于设置已验证网关的信息。

默认配置

日志（包括指标以及请求和响应数据）默认为每个网关启用。此日志记录行为将统一应用于网关中的所有请求。如果您担心隐私或合规性并想关闭日志收集，您可以转到设置并选择退出日志。如果您需要为特定请求修改日志设置，您可以在每个请求的基础上覆盖此设置。

To change the default log configuration in the dashboard:

1. Log in to the Cloudflare dashboard ↗ and select your account.
2. Go to AI > AI Gateway.
3. Select Settings.
4. Change the Logs setting to your preference.

每个请求的日志记录

要覆盖在设置选项卡中设置的默认日志记录行为，您可以在每个请求的基础上定义标头。

收集日志 (cf-aig-collect-log)

cf-aig-collect-log 标头允许您绕过网关的默认日志设置。如果网关配置为保存日志，标头将排除该特定请求的日志。相反，如果在网关级别禁用日志记录，此标头将为该请求保存日志。

在下面的示例中，我们使用 cf-aig-collect-log 绕过默认设置以避免保存日志。

curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/openai/chat/completions \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --header 'cf-aig-collect-log: false \
  --data ' {
        "model": "gpt-4o-mini",
        "messages": [
          {
            "role": "user",
            "content": "What is the email address and phone number of user123?"
          }
        ]
      }
'

管理日志存储

要有效管理您的日志存储，您可以：

• 设置存储限制：在您的网关设置中配置每个网关存储的日志数量限制，以确保您只为所需的内容付费。
• 启用自动日志删除：在您的网关设置中激活自动日志删除功能，以在达到您设置的日志限制或默认存储限制 1000 万条日志时自动删除最旧的日志。这确保新日志始终得到保存，无需手动干预。

如何删除日志

要有效管理您的日志存储并确保持续日志记录，您可以使用以下方法删除日志：

自动日志删除

要在网关存储约束内维持持续日志记录，请在您的网关设置中启用自动日志删除。此功能在达到您设置的日志限制或默认存储限制 1000 万条日志时自动删除最旧的日志，确保新日志得到保存，无需手动干预。

手动删除

要通过仪表板手动删除日志，请导航到仪表板中的日志选项卡。使用可用的过滤器，如状态、缓存、提供商、成本或下拉菜单中的任何其他选项来细化您希望删除的日志。过滤后，选择删除日志以完成操作。

请参阅下面可用过滤器及其描述的完整列表：

过滤器类别	过滤器选项	过滤器描述
状态	错误，状态	错误类型或状态。
缓存	已缓存，未缓存	基于是否被缓存。
提供商	特定提供商	选定的 AI 提供商。
AI 模型	特定模型	选定的 AI 模型。
成本	小于，大于	成本，指定阈值。
请求类型	通用，Workers AI 绑定，WebSockets	请求的类型。
令牌	总令牌，输入令牌，输出令牌	令牌计数（小于或大于）。
持续时间	小于，大于	请求持续时间。
反馈	等于，不等于（赞，踩，无反馈）	反馈类型。
元数据键	等于，不等于	特定元数据键。
元数据值	等于，不等于	特定元数据值。
日志 ID	等于，不等于	特定日志 ID。
事件 ID	等于，不等于	特定事件 ID。

API 删除

您可以使用 AI 网关 API 以编程方式删除日志。有关 DELETE 日志端点的更全面信息，请查看 Cloudflare API 文档。