← Cloudflare Logs / logs

Logs Engine

Logs Engine vám umožňuje ukládat protokoly do R2 a přímo je dotazovat.

• Nastavte Logpush do R2 úlohy.
• Vytvořte R2 access key s alespoň oprávněními ke čtení R2.
• Ujistěte se, že máte oprávnění ke čtení Logshare.
• Alternativně vytvořte token Cloudflare API s následujícími oprávněními:
  • Rozsah účtu
  • Oprávnění ke čtení protokolů

Protokoly můžete pomocí API dotazovat a stahovat podle časového rozsahu nebo RayID.

Pro všechna volání API jsou vyžadovány následující hlavičky:

• X-Auth-Email - e-mailová adresa účtu Cloudflare přiřazená k doméně
• X-Auth-Key - klíč API Cloudflare

Alternativně lze k autentizaci použít také API tokeny s oprávněním Logs edit:

• Authorization: Bearer <API_TOKEN>

Kromě zmíněných povinných autentizačních hlaviček jsou pro přístup API k protokolům uloženým ve vašem bucketu R2 vyžadovány následující hlavičky.

• R2-access-key-id (povinné) - R2 Access Key Id
• R2-secret-access-key (povinné) - R2 Secret Access Key

Vypište relevantní objekty R2 obsahující protokoly odpovídající zadaným parametrům dotazu pomocí endpointu GET /accounts/{accountId}/logs/list.

• start (povinné) string (TimestampRFC3339) - počáteční čas ve formátu RFC 3339, například start=2022-06-06T16:00:00Z.

• end (povinné) string (TimestampRFC3339) - koncový čas ve formátu RFC 3339, například end=2022-06-06T16:00:00Z.

• bucket (povinné) string (Bucket) - název bucketu R2, například bucket=cloudflare-logs.

• prefix řetězec (Prefix), pod kterým se protokoly v R2 bucketu ukládají, například prefix=http_requests/example.com/{DATE}.

• limit číslo (Limit): maximální počet výsledků k vrácení, například limit=100.

Streamujte protokoly uložené v R2, které odpovídají zadaným parametrům dotazu, pomocí endpointu GET /accounts/{accountId}/logs/retrieve.

• start (povinné) string (TimestampRFC3339) - počáteční čas ve formátu RFC 3339, například start=2022-06-06T16:00:00Z

• end (povinné) string (TimestampRFC3339) - koncový čas ve formátu RFC 3339, například end=2022-06-06T16:00:00Z

• bucket (povinné) string (Bucket) - název bucketu R2, například bucket=cloudflare-logs

• prefix řetězec (Prefix), pod kterým se protokoly v R2 bucketu ukládají, například prefix=http_requests/example.com/{DATE}

curl --globoff "https://api.cloudflare.com/client/v4/accounts/{account_id}/logs/retrieve?start=2022-06-01T16:00:00Z&end=2022-06-01T16:05:00Z&bucket=cloudflare-logs&prefix=http_requests/example.com/{DATE}" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "R2-Access-Key-Id: R2_ACCESS_KEY_ID" \
--header "R2-Secret-Access-Key: R2_SECRET_ACCESS_KEY"

Výsledky lze do souboru přesměrovat pomocí > logs.json.

Pokud navíc chcete přijímat nezpracovaná data GZIP, aniž by je váš klient transparentně dekomprimoval, přidejte hlavičku --header "Accept-Encoding: gzip".

Pomocí protokolů uložených v R2 - funkce Logpull RayID Lookup umožňuje dotazovat se na indexovaný časový rozsah na přítomnost RayID a vrátit odpovídající výsledek. Tato funkce je dostupná uživatelům s beta předplatným Logpull RayID Lookup.

Vyhledání RayID je dvoukrokový proces. Nejprve je potřeba, aby byl indexován časový rozsah, teprve poté lze o záznam podle RayID požádat.

Indexy automaticky vyprší po sedmi dnech bez použití.

Před spuštěním dotazu můžete zadat časový rozsah, který chcete indexovat, a zúžit tak rozsah dotazu. V následujícím příkladu indexujeme jednu minutu protokolů uložených v bucketu R2 "cloudflare-logs" pod prefixem "http_requests/{DATE}".

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/logs/rayids/index \
--header "Authorization: Bearer <API_TOKEN>" \
--header "R2-Access-Key-Id: <R2_ACCESS_KEY_ID>" \
--header "R2-Secret-Access-Key: <R2_SECRET_ACCESS_KEY>" \
--header "Content-Type: application/json" \
--data-raw '{
  "start": "2022-08-16T20:30:00Z",
  "end": "2022-08-16T20:31:00",
  "bucket": "cloudflare-logs",
  "prefix": "http_requests/example.com/{DATE}"
}'

Po indexování časového rozsahu proveďte GET požadavek s RayID. Pokud se v indexovaném časovém rozsahu najde odpovídající výsledek, záznam se vrátí. Upozorňujeme, že se parametry přesunuly z těla požadavku do URL. -g příznak je nutný, aby se předešlo {DATE} parametr, aby ho cURL nesprávně neinterpretoval.

curl --globoff "https://api.cloudflare.com/client/v4/accounts/{account_id}/logs/rayids/<RAY_ID>?bucket=cloudflare-logs&prefix=http_requests/example.com/{DATE}" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "R2-Access-Key-Id: <R2_ACCESS_KEY_ID>" \
--header "R2-Secret-Access-Key: <R2_SECRET_ACCESS_KEY>"