启用 Datadog

Cloudflare Logpush 支持通过 Cloudflare 仪表板或 API 将日志直接推送到 Datadog。

1. 在 Cloudflare 仪表板中，前往账户或域名（也称为 zone）级别的 Logpush（日志推送） 页面。

   账户级别：Go to Logpush ↗

   域名（也称为 zone）级别：Go to Logpush ↗

2. 根据你的选择，可分别访问账户范围数据集与 zone 范围数据集。

3. 选择 Create a Logpush job（创建 Logpush 作业）。

4. 在 **Select a destination（选择目标）**中，选择 Datadog。

5. 输入或选择以下目标信息：

   • Datadog URL Endpoint（Datadog URL 端点），可以是以下之一。您可以在 Datadog API 参考文档 ↗ 中找到它们的区别。

• Datadog API Key（Datadog API 密钥），可通过遵循这些步骤 ↗获取。

• Service（服务）、Hostname（主机名）、Datadog ddsource field（Datadog ddsource 字段） 和 ddtags 字段可以作为 URL 参数设置。更多信息请参阅 Datadog 文档中的 Logs（日志）部分 ↗。虽然这些参数是可选的，但它们对索引或处理日志很有用。请注意，这些参数的值可能包含特殊字符，应进行 URL 编码。

输入完目标详细信息后，选择 Continue（继续）。

6. 选择要推送到存储服务的数据集。

7. 在下一步中，需要配置您的 Logpush 作业：

   • 输入 Job name（作业名称）。
   • 在 **If logs match（如果日志匹配）**下，可以选择要包含和/或从日志中排除的事件。更多信息请参阅 Filters（筛选器）。并非所有数据集都提供此选项。
   • 在 **Send the following fields（发送以下字段）**中，可以选择将所有日志推送到存储目标，或有选择地推送部分日志。

8. 在 **Advanced Options（高级选项）**中，您可以：

   • 选择日志中时间戳字段的格式（RFC3339（默认）、Unix 或 UnixNano）。
   • 为日志选择采样率，或推送随机采样百分比的日志。
   • 为 CVE-2021-44228 启用脱敏。此选项会将所有 ${ 替换为 x{。

9. 配置完 Logpush 作业后，选择 Submit（提交）。

要设置 Datadog Logpush 作业：

1. 使用适当的端点 URL 和身份验证参数创建作业。
2. 启用作业以开始推送日志。

在尝试读取或配置 Logpush 任务之前，请确保已启用 Log Share 权限。更多信息请参阅角色部分。

要创建作业，请向 Logpush jobs 端点发送 POST 请求，并包含以下字段：

• name（可选）- 使用您的域名作为作业名称。

• destination_conf - 由端点 URL、授权标头以及 Datadog 在以下字符串格式中支持的零个或多个可选参数组成的日志目标。

  • <DATADOG_ENDPOINT_URL>：Datadog HTTP 日志接入端点，可以是以下之一。您可以在 Datadog API 参考文档 ↗ 中找到它们的区别。
  https://http-intake.logs.datadoghq.com/v1/input

  https://http-intake.logs.datadoghq.com/api/v2/logs

• <DATADOG_API_KEY>：Datadog API 令牌可通过遵循这些步骤 ↗获取。例如，20e6d94e8c57924ad1be3c29bcaee0197d。

• ddsource：设置为 cloudflare。

• service、host、ddtags：Datadog 允许的可选参数。

"datadog://<DATADOG_ENDPOINT_URL>?header_DD-API-KEY=<DATADOG_API_KEY>&ddsource=cloudflare&service=<SERVICE>&host=<HOST>&ddtags=<TAGS>"

• dataset - 您要接收的日志类别。完整支持的数据集列表请参阅 Datasets（数据集）。
• output_options（可选）- 要配置字段、采样率和时间戳格式，请参阅 Log Output Options（日志输出选项）。

使用 cURL 的示例请求：

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/logpush/jobs" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "<DOMAIN_NAME>",
		"destination_conf": "datadog://<DATADOG_ENDPOINT_URL>?header_DD-API-KEY=<DATADOG_API_KEY>&ddsource=cloudflare&service=<SERVICE>&host=<HOST>&ddtags=<TAGS>",
		"output_options": {
				"field_names": [
						"ClientIP",
						"ClientRequestHost",
						"ClientRequestMethod",
						"ClientRequestURI",
						"EdgeEndTimestamp",
						"EdgeResponseBytes",
						"EdgeResponseStatus",
						"EdgeStartTimestamp",
						"RayID"
				],
				"timestamp_format": "rfc3339"
		},
		"dataset": "http_requests",
		"enabled": true
	}'

响应：

{
  "errors": [],
  "messages": [],
  "result": {
    "id": <JOB_ID>,
    "dataset": "http_requests",
    "kind": "",
    "enabled": true,
    "name": "<DOMAIN_NAME>",
    "output_options": {
      "field_names": ["ClientIP", "ClientRequestHost", "ClientRequestMethod", "ClientRequestURI", "EdgeEndTimestamp", "EdgeResponseBytes", "EdgeResponseStatus" ,"EdgeStartTimestamp", "RayID"],
      "timestamp_format": "rfc3339"
    },
    "destination_conf": "datadog://<DATADOG_ENDPOINT_URL>?header_DD-API-KEY=<DATADOG_API_KEY>",
    "last_complete": null,
    "last_error": null,
    "error_message": null
  },
  "success": true
}

有关更新作业（包括启用和禁用），请参阅 Manage Logpush with cURL（使用 cURL 管理 Logpush）。

请注意以下 Logpush 发送限制，如 Datadog 文档 ↗ 中所述。

通过 HTTP 将日志发送到您的 Datadog 平台。每个 HTTP 请求的限制如下：

• 每个载荷的最大内容大小（未压缩）：5 MB
• 单条日志的最大大小：1 MB
• 如果以数组形式发送多条日志，最大数组大小：1,000 个条目