← Log Explorer / log-explorer

Поиск по журналам

Log Explorer позволяет хранить и изучать журналы Cloudflare прямо в панели управления Cloudflare или через API, обеспечивая полную видимость журналов без необходимости пересылать их сторонним сервисам. Журналы хранятся в глобальной сети Cloudflare с использованием платформы объектного хранения R2 и доступны для запросов через панель управления или SQL API.

Используйте Log Explorer, когда нужно выяснить, что именно происходило с реальным продакшен-трафиком:

• Анализ исторических данных и тенденций
• Расследование инцидентов безопасности после их возникновения
• Поиск закономерностей среди тысяч запросов
• Мониторинг производительности приложения с течением времени
• Предоставление криминалистических данных группам поддержки

Используйте Trace когда нужно проверить, что произойдёт при имитации запроса:

• Почему правило не сработало так, как ожидалось
• Проверка того, как ваши правила обрабатывают различные сценарии запросов
• Просмотр порядка оценки ваших правил
• Имитация запросов из разных геолокаций или условий

Главное отличие в том, что Log Explorer показывает реальный трафик, а Trace показывает смоделированные сценарии «что если».

Вы можете фильтровать и просматривать логи в панели управления Cloudflare или через API.

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

   Перейдите в Log Search ↗

2. Выберите Набор данных который хотите использовать, а в Столбцы выберите поля набора данных. Если вы выбрали набор данных на уровне зоны, укажите нужную зону.

3. Введите Лимит. Лимит представляет собой максимальное количество возвращаемых результатов, например 50.

4. Выберите Период времени по которым вы хотите выполнить запрос, например, за последние 12 часов.

5. Выберите Добавить фильтр чтобы создать запрос. Выберите Поле, Оператор, а также Значение, затем выберите Применить.

6. Отображается предпросмотр запроса. Выберите Пользовательский SQL чтобы изменить запрос.

7. Выберите Выполнить запрос когда закончите. Результаты отображаются ниже, в Результаты запроса раздел.

Например, чтобы найти HTTP-запрос с определённым Ray ID, перейдите в Пользовательский SQL, и введите следующий SQL-запрос:

SELECT
	clientRequestScheme,
	clientRequestHost,
	clientRequestMethod,
	edgeResponseStatus,
	clientRequestUserAgent
FROM http_requests
WHERE RayID = '806c30a3cec56817'
LIMIT 1

Ещё один пример: чтобы найти запросы Cloudflare Access с нужными столбцами за определённый период, выполните следующий SQL-запрос:

SELECT
	CreatedAt,
	AppDomain,
	AppUUID,
	Action,
	Allowed,
	Country,
	RayID,
	Email,
	IPAddress,
	UserUID
FROM access_requests
WHERE Date >= '2025-02-06' AND Date <= '2025-02-06' AND CreatedAt >= '2025-02-06T12:28:39Z' AND CreatedAt <= '2025-02-06T12:58:39Z'

Чтобы запрашивать заголовки запросов, заголовки ответов и файлы cookie, сначала включите журналирование этих полей с помощью Пользовательские поля. Настройте список пользовательских полей через API или панель управления; изменять само задание Logpush не требуется.

Пример ниже показывает, как запрашивать HTTP-запросы по дате, времени, стране клиента и произвольному заголовку запроса. Заранее убедитесь, что нужные заголовки или файлы cookie включены в журналирование.

SELECT clientip, clientrequesthost, clientrequestmethod, edgeendtimestamp, edgestarttimestamp, rayid, clientcountry, requestheaders
FROM http_requests
WHERE Date >= '2025-07-17'
  AND Date <= '2025-07-17'
  AND edgeendtimestamp >= '2025-07-17T07:54:19Z'
  AND edgeendtimestamp <= '2025-07-18T07:54:19Z'
  AND clientcountry = 'us'
  AND requestheaders."x-test-header" like '%654AM%';

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

Панель управления Log Explorer также можно открыть напрямую из Дашборд Security Analytics. При этом фильтры, применённые в Security Analytics, автоматически перенесутся в ваш запрос в Log Explorer.

Все таблицы, поддерживаемые Log Explorer, содержат специальный столбец с именем date, что помогает сократить объём данных, сканируемых для ответа на запрос, и ускоряет время его выполнения. Значение date должно иметь вид YYYY-MM-DD. Например, чтобы получить логи за 12 октября 2023 года, добавьте следующее в WHERE конструкция: date = '2023-10-12'. Столбец поддерживает стандартные операторы <, >, а также =.

1. Войдите в Панель управления Cloudflare ↗ и выберите свой аккаунт.
2. Перейдите в Log Explorer > Поиск по журналам > Пользовательский SQL.
3. Введите следующий SQL-запрос:

SELECT
	clientip,
	clientrequesthost,
	clientrequestmethod,
	clientrequesturi,
	edgeendtimestamp,
	edgeresponsestatus,
	originresponsestatus,
	edgestarttimestamp,
	rayid,
	clientcountry,
	clientrequestpath,
	date
FROM
	http_requests
WHERE
	date = '2023-10-12' LIMIT 500

• Сузьте временной диапазон запроса. Используйте меньший временной интервал, чтобы уменьшить объём обрабатываемых данных. Это позволяет не запрашивать лишние объёмы данных и ускоряет получение результата.
• Опустите ORDER BY и LIMIT конструкций. Такие конструкции могут замедлять запросы, особенно при работе с большими наборами данных. Для запросов, возвращающих большое количество записей, лучше сократить временной диапазон, а не ограничиваться самыми новыми N записей за более широкий период времени.
• Выбирайте только нужные столбцы. Например, замените SELECT * со списком конкретных нужных вам столбцов. Также можно использовать SELECT RayId в качестве первого шага, а затем выполнить запрос с фильтрацией по Ray ID для получения дополнительных столбцов. Кроме того, вы можете использовать SELECT COUNT(*) чтобы найти временные интервалы с подходящими записями, не извлекая весь набор данных.