データセットを管理する

Log Explorer では、Log Search でクエリできるデータセットを有効化、無効化、または削除できます。

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 で、Log Explorer が保存するデータポイントを制御します。フィールドはカテゴリごとにグループ化され、各カテゴリには選択中のフィールド数が表示されます。カテゴリを選択すると、そのグループの全フィールドを追加または削除できます。カテゴリを展開して、個別のフィールドを選ぶこともできます。各フィールドにはデータ型が表示されます。

必須フィールドは選択されたままになり、Required と表示されます。Cloudflare が推奨しなくなったフィールドは Deprecated と表示されます。利用可能なすべてのフィールドを含めるには Select all を、データセットのデフォルトに戻すには Reset to default を選択します。

Filter logs で、All events を取り込むか、Only events matching a filter だけを取り込むかを選びます。フィルター条件は、フィールド、演算子、値で構成されます。グループ内の条件はすべて一致する必要があります。イベントは、いずれかのフィルターグループに一致すれば対象になります。

有効済みデータセットのフィールドまたはフィルターを変更するには、Log Explorer > Manage datasets を開きます。データセットを見つけ、Actions > Edit を選択し、設定を更新して Update を選択します。

保存したい各データセットを、Log Explorer API で有効にします。ログストリームを有効にしたあと、ログを表示できるようになるまで数分かかることがあります。

次の 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"
}'

データセットを削除すると、データセットとその保存データは完全に削除されます。削除は非同期で実行されます。削除の進行中は、同じデータセットをアカウントまたはゾーンに再作成できません。