管理数据集

你可以启用、禁用或删除可在 Logs 中查询的 Log Explorer 数据集。

Log Explorer 目前支持以下数据集：

• HTTP Requests (http_requests)
• Firewall Events (firewall_events)
• DNS Logs (dns_logs)
• NEL Reports (nel_reports)
• Page Shield Events (page_shield_events)（客户端安全事件）
• Spectrum Events (spectrum_events)
• Zaraz Events (zaraz_events)

• Access requests (access_requests)
• CASB findings (casb_findings)
• Device posture results (device_posture_results)
• Gateway DNS (gateway_dns)
• Gateway HTTP (gateway_http)
• Gateway Network (gateway_network)
• Zero Trust Network Session Logs (zero_trust_network_sessions)
• Audit Logs (audit_logs)
• Audit_logs_v2 (audit_logs_v2)
• Browser Isolation User Actions (biso_user_actions)
• DNS firewall logs (dns_firewall_logs)
• Email security alerts (email_security_alerts)
• Magic BGP Logs (magic_bgp_logs)
• Magic IDS Detections (magic_ids_detections)
• Network Analytics (network_analytics_logs)
• Sinkhole HTTP Logs (sinkhole_http_logs)
• IP Sec Logs (ipsec_logs)

要开始存储日志，请通过仪表板或 API 启用所需数据集。

使用 Select fields（选择字段） 控制存储哪些数据点。字段按类别分组，每个类别显示已选字段数量。选择一个类别可添加或移除该组中的所有字段，或展开类别以选择单个字段。每个字段都会显示其数据类型。

必填字段保持选中，并标记为 Required（必需）。Cloudflare 不再推荐的字段标记为 Deprecated（已弃用）。选择 Select all（全选） 可包含所有可用字段，或选择 Reset to default（重置为默认） 以恢复数据集默认值。

使用 Filter logs（过滤日志） 摄取 All events（所有事件） 或 Only events matching a filter（仅匹配过滤器的事件）。过滤条件由字段、运算符和值组成。组内的所有条件都必须匹配。事件可以匹配任一过滤器组。

要更改已启用数据集的字段或过滤器，请打开 Manage datasets（管理数据集） 页面。找到该数据集，选择 Actions（操作） > Edit（编辑），更新配置，然后选择 Update（更新）。

使用 API 为你希望存储的每个数据集启用 Log Explorer。启用日志流之后，可能需要等待几分钟才能查看日志。

以下 curl 命令是启用区域级数据集 http_requests 的示例，以及命令成功时的预期响应。

curl https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/explorer/datasets \
--header "Authorization: Bearer <API_TOKEN>" \
--json '{
  "dataset": "http_requests"
}'

{
	"result": {
		"dataset": "http_requests",
		"object_type": "zone",
		"object_id": "<ZONE ID>",
		"created_at": "2025-06-03T14:33:16Z",
		"updated_at": "2025-06-03T14:33:16Z",
		"dataset_id": "01973635f7e273a1964a02f4d4502499",
		"enabled": true,
		"deletion_protection": true
	},
	"success": true,
	"errors": [],
	"messages": []
}

要启用账户级数据集，请在 curl 命令中将 zones/{zone_id} 替换为 accounts/{account_id}。例如：

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/logs/explorer/datasets \
--header "Authorization: Bearer <API_TOKEN>" \
--json '{
  "dataset": "access_requests"
}'

删除数据集将永久移除该数据集及其已存储数据。删除以异步方式运行。删除进行期间，你无法为同一账户或 zone 重新创建相同数据集。