← Log Explorer / log-explorer

Управление датасетами

Log Explorer позволяет включать, отключать и удалять наборы данных, доступные для запросов в Log Search.

В настоящее время Log Explorer поддерживает следующие наборы данных:

• HTTP-запросы (http_requests)
• Firewall Events (firewall_events)
• Журналы DNS (dns_logs)
• Отчёты NEL (nel_reports)
• События Page Shield (page_shield_events) (события для client-side security)
• События Spectrum (spectrum_events)
• События Zaraz (zaraz_events)

• Запросы Access (access_requests)
• Результаты CASB (casb_findings)
• Результаты проверки состояния устройства (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 (biso_user_actions)
• журналы брандмауэра DNS (dns_firewall_logs)
• Уведомления Email security (email_security_alerts)
• Magic IDS Detections (magic_ids_detections)
• Network Analytics (network_analytics_logs)
• Журналы HTTP Sinkhole (sinkhole_http_logs)
• Журналы IPsec (ipsec_logs)

Чтобы Log Explorer начал сохранять журналы, включите нужные наборы данных. Это можно сделать через панель управления или API.

1. На панели управления Cloudflare перейдите к разделу Log Explorer > Управление датасетами страницу.

   Перейдите в Управление датасетами ↗

2. Выберите Добавить набор данных чтобы выбрать наборы данных, по которым вы хотите выполнять запросы.

3. Выберите набор данных, а затем зону. Затем выберите Add. Вы всегда можете вернуться на эту страницу, чтобы включить дополнительные наборы данных или управлять уже включёнными.

Если вы используете API, включите Log Explorer для каждого набора данных, который хотите сохранять, с помощью 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": []
}

Чтобы включить набор данных на уровне аккаунта, замените zones/{zone_id} с accounts/{account_id} в curl команду. Например:

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

Удаление набора данных приводит к безвозвратному удалению самого набора и хранящихся в нём данных. Удаление выполняется асинхронно. Пока оно не завершится, повторно создать такой же набор данных для аккаунта или зоны нельзя.