← Cloudflare Logs / logs / logpull

Další podrobnosti

Chcete-li odhadnout množství dat pro zónu za den (počet řádků protokolu a množství bajtů, které zabírají), vyžádejte si 1% nebo 10% vzorek dat za období 1 hodiny (pokud je váš objem nízký, použijte 10 %). Upozorňujeme, že start=2018-12-15T00:00:00Z a end=2018-12-15T01:00:00Z pokrývají období 1 hodiny a sample=0.1.

curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/received?start=2018-12-15T00:00:00Z&end=2018-12-15T01:00:00Z&sample=0.1" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
> sample.log

wc -l sample.log

83 sample.log

ls -lh sample.log

-rw-r--r-- 1 mik mik 25K Dec 17 15:49 sample.log

Na základě těchto informací je přibližný počet zpráv za den 19,920 (83 × 10 × 24) a velikost v bajtech 6MB (25K × 10 × 24). Odhad velikosti vychází z výchozí sady polí odpovědi. Změna sady polí odpovědi (viz Pole) změní velikost odpovědi.

Chcete-li získat dobrý odhad denního provozu, je nejlepší mít ve vzorku za hodinu alespoň 30 řádků protokolu. Pokud je velikost odpovědi příliš malá (nebo příliš velká), upravte hodnotu vzorku, nikoli časové rozmezí.

Odpovědi jsou ve výchozím nastavení komprimované (gzip). cURL transparentně dekomprimuje odpovědi, pokud není volán s:

--header "Accept-Encoding: gzip"

V takovém případě zůstává výstup komprimovaný pomocí gzip. Komprimovaná data zabírají přibližně 5-10 % velikosti nekomprimovaných dat. To znamená, že nekomprimovaná odpověď o velikosti 1 GB se zkomprimuje na 50-100 MB.

Pokud je překročen limit odpovědi nebo časový limit, nebo pokud dojde k libovolnému problému při načítání odpovědi, 200 stav bude vrácen a odpověď skončí non-JSON textovým řádkem „Error streaming data.“ Protože jsou odpovědi streamovány, chybu nelze rozpoznat předem. Odpověď je úspěšná, pokud nekončí textovým řádkem „Error streaming data“.

Jakmile pro danou zónu a časový rozsah obdržíte úspěšnou odpověď, platí pro všechny další požadavky následující:

• Počet a obsah vrácených záznamů budou stejné.
• Pořadí vrácených záznamů se může (a pravděpodobně bude) lišit.

Pokud jde o zahrnutí pole parametr:

• Pokud jsou pole v URL požadavku uvedena výslovně, vrácená pole se nezmění.
• Pokud nejsou v URL uvedena, vrátí se výchozí pole.
• Výchozí pole se mohou kdykoli změnit.

Platí následující omezení použití:

• Limity rychlosti: Překročení těchto limitů vede k 429 chybovou odpověď:
  • 15 požadavků za minutu na zónu.
  • 180 požadavků za minutu na uživatele (e-mailovou adresu).
• Časové rozmezí: Maximální rozdíl mezi start a end parametrů může být 1 hodina.
• Velikost odpovědi: Maximální velikost odpovědi je 10GiB na požadavek, což odpovídá přibližně 15M záznamům při výběru přibližně 55 polí (při výběru menšího počtu polí lze získat více záznamů, protože velikost jednoho záznamu bude menší).
• Časový limit: Odpověď selže s ukončeným připojením po 10 minutách.
• Časový limit streamu: Požadavek bude ukončen s 408 chybovou odpověď, pokud je spojení 30 sekund neaktivní. Toto vypršení časového limitu obvykle znamená, že požadavek je pravděpodobně příliš náročný (časté vypršení časového limitu, více než 12 za hodinu, povede k tomu, že následující dotazy budou na 1 hodinu blokovány se stavovým kódem 429), a proto:
  • zkuste požadovat záznamy s menším počtem polí.
  • zkuste menší start a end parametry.