INTEGRITY Dokumentace

← Log Explorer / log-explorer

Vyhledávání v protokolech

Log Explorer vám umožňuje ukládat a prohledávat protokoly Cloudflare přímo v dashboardu Cloudflare nebo přes API, takže do nich máte přehled, aniž byste je museli přeposílat do služeb třetích stran. Protokoly se ukládají v globální síti Cloudflare pomocí úložné platformy R2 object storage a lze je dotazovat přes dashboard nebo SQL API.

Kdy použít Log Explorer

Log Explorer použijte, pokud potřebujete zjistit, co se skutečně dělo v reálném produkčním provozu:

Použijte Trasování když potřebujete otestovat, co by se stalo při simulovaném požadavku:

Klíčový rozdíl je v tom, že Log Explorer zobrazuje skutečný provoz, zatímco Trace zobrazuje simulované scénáře typu „co kdyby“.

Použití Log Explorer

Logy můžete filtrovat a zobrazovat prostřednictvím Cloudflare dashboardu nebo API.

  1. V dashboardu Cloudflare přejděte na Log Explorer > Vyhledávání v protokolech stránce.

    Přejděte na Vyhledávání v protokolech ↗

  2. Vyberte Dataset který chcete použít, a v Sloupce vyberte pole datové sady. Pokud jste vybrali datovou sadu s rozsahem na úrovni zóny, vyberte zónu, kterou chcete použít.

  3. Zadejte Limit. Limit je maximální počet výsledků, které se mají vrátit, například 50.

  4. Vyberte Časové období ze kterého chcete data dotazovat, například posledních 12 hodin.

  5. Vyberte Přidat filtr k vytvoření dotazu. Vyberte Pole, Operátor, a Hodnota, pak vyberte Použít.

  6. Zobrazí se náhled dotazu. Vyberte Vlastní SQL a změňte dotaz.

  7. Vyberte Spustit dotaz až budete hotovi. Výsledky se zobrazí níže v Výsledky dotazu sekce.

Chcete-li například vyhledat HTTP požadavek s konkrétním Ray ID, přejděte na Vlastní SQL, a zadejte následující dotaz SQL:

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

Jako další příklad: chcete-li najít požadavky Cloudflare Access s vybranými sloupci za určité časové období, můžete použít následující dotaz 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'

Hlavičky a cookies

Chcete-li se dotazovat na hlavičky požadavků, hlavičky odpovědí a soubory cookie, musíte nejprve zapnout protokolování těchto polí pomocí Vlastní pole. Seznam vlastních polí nakonfigurujte pomocí API nebo dashboardu, úlohu Logpush samotnou není třeba upravovat.

Následující příklad ukazuje, jak dotazovat HTTP požadavky podle data, časového razítka, země klienta a vlastní hlavičky požadavku. Nezapomeňte si předem zapnout protokolování konkrétních hlaviček nebo souborů cookie, na které se chcete dotazovat.

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%';

Ukládání dotazů

Po výběru všech polí pro váš dotaz jej můžete uložit výběrem Uložit dotaz. Zadejte název a popis, které vám pomohou dotaz později identifikovat. Uložené a nedávné dotazy zobrazíte tak, že vyberete Dotazy : zobrazí se v postranním panelu, kde můžete vložit nový dotaz nebo libovolný dotaz odstranit.

Integrace se Security Analytics

K dashboardu Log Explorer se také můžete dostat přímo z Řídicí panel Security Analytics. Filtry, které jste použili v Security Analytics, se tak automaticky přenesou do vašeho dotazu v Log Exploreru.

Optimalizujte své dotazy

Všechny tabulky podporované Log Explorerem obsahují speciální sloupec s názvem date, což pomáhá omezit množství dat prohledávaných při zpracování dotazu, a zrychluje tak odezvu dotazu. Hodnota date musí mít podobu YYYY-MM-DD. Chcete-li například vyhledat protokoly ze dne October 12, 2023, přidejte následující do svého WHERE klauzule: date = '2023-10-12'. Sloupec podporuje standardní operátory typu <, >, a =.

  1. Přihlaste se do Cloudflare dashboard ↗ a vyberte svůj účet.
  2. Přejděte na Log Explorer > Vyhledávání v protokolech > Vlastní SQL.
  3. Zadejte následující SQL dotaz:
SELECT
	clientip,
	clientrequesthost,
	clientrequestmethod,
	clientrequesturi,
	edgeendtimestamp,
	edgeresponsestatus,
	originresponsestatus,
	edgestarttimestamp,
	rayid,
	clientcountry,
	clientrequestpath,
	date
FROM
	http_requests
WHERE
	date = '2023-10-12' LIMIT 500

Další tipy pro optimalizaci dotazů