Log Explorer API

Konfigurace a vyhledávání v protokolech jsou dostupné také prostřednictvím veřejného API.

Ověřování

Ověření u API lze provést pomocí API tokenu nebo API klíče s e-mailem. Více informací najdete v Vytvoření API tokenu pro další pokyny.

Podrobné informace o oprávněních požadovaných pro jednotlivé funkce Log Exploreru najdete v Oprávnění sekce.

Dotazování dat

Log Explorer obsahuje SQL API pro odesílání dotazů.

Chcete-li například vyhledat HTTP požadavek s konkrétním Ray ID, použijte následující dotaz SQL:

curl https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/explorer/query/sql \
--header "Authorization: Bearer <API_TOKEN>" \
--url-query query="SELECT clientRequestScheme, clientRequestHost, clientRequestMethod, edgeResponseStatus, clientRequestUserAgent FROM http_requests WHERE RayID = '806c30a3cec56817' LIMIT 1"

Tento příkaz vrátí následující podrobnosti o HTTP požadavku:

{
	"result": [
		{
			"clientrequestscheme": "https",
			"clientrequesthost": "example.com",
			"clientrequestmethod": "GET",
			"clientrequestuseragent": "curl/7.88.1",
			"edgeresponsestatus": 200
		}
	],
	"success": true,
	"errors": [],
	"messages": []
}

Jako další příklad můžete požadavky Cloudflare Access s vybranými sloupci za určité časové období najít pomocí následujícího dotazu SQL:

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/logs/explorer/query/sql \
--header "Authorization: Bearer <API_TOKEN>" \
--url-query query="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'"

Tento příkaz vrátí následující podrobnosti o požadavku:

{
	"result": [
		{
			"createdat": "2025-01-14T18:17:55Z",
			"appdomain": "example.com",
			"appuuid": "a66b4ab0-ccdf-4d60-a6d0-54a59a827d92",
			"action": "login",
			"allowed": true,
			"country": "us",
			"rayid": "90fbb07c0b316957",
			"email": "[email protected]",
			"ipaddress": "1.2.3.4",
			"useruid": "52859e81-711e-4de0-8b31-283336060e79"
		}
	],
	"success": true,
	"errors": [],
	"messages": []
}