INTEGRITY Dokumentace

Stavové dashboardy pro Logpush

Stavové dashboardy pro Logpush vám poskytují přehledný náhled na výkon a spolehlivost vašich úloh Logpush. Můžete sledovat stav doručování protokolů, diagnostikovat problémy a zjišťovat objem dat odesílaných do nakonfigurovaných cílů. Díky tomu máte jistotu, že kritická data protokolů pro zabezpečení, dodržování předpisů a observabilitu vždy proudí tak, jak mají.

Zůstaňte informováni pomocí stavových oznámení

Nakonfigurujte stavová oznámení pro Logpush a nechte si posílat výstrahy, když je vaše úloha Logpush deaktivovaná nebo dochází k chybám. Včasná detekce je klíčová, protože Logpush neumí protokoly zpětně doplnit: jakmile jsou data zahozena, jsou nenávratně ztracena.

Stavová oznámení fungují společně se stavovým dashboardem a poskytují jak upozornění v reálném čase, tak historickou analýzu výkonu vaší úlohy Logpush.


Stavové dashboardy pro Access

  1. V Cloudflare dashboard, přejděte do Logpush stránku na úrovni účtu nebo domény (zóny).
  2. Přejděte na Stav kartě.
  3. Vyberte úlohu, kterou chcete analyzovat.
  4. Zadejte časový rozsah, který chcete zkontrolovat.
  5. (Volitelné) Z Úlohy kartě vyhledejte úlohu, kterou chcete analyzovat.
  6. Najeďte myší na Stav úloh (24h) pro danou úlohu a vyberte Zobrazit stav.
  7. Budete přesměrováni na Stav kartě, kde můžete vybrat požadované časové rozmezí pro analýzu.

Dostupnost dat a přístup k API

Klíčové pojmy v oblasti stavu úloh

Řádek protokolu

Jeden záznam logu vygenerovaný Cloudflare, například HTTP požadavek, DNS dotaz nebo událost Access.

Batch

Skupina logů, které Cloudflare nahrává do vašeho cíle společně jako jeden soubor nebo požadavek. Dávka se také označuje jako soubor.

Nahrát

Jeden pokus o nahrání dávky logů do vašeho cíle. Pokud první pokus selže, Cloudflare automaticky opakuje nahrávání, dokud se nezdaří nebo dokud není dosažen limit opakování. Každé nahrání může mít jeden ze tří výsledků: Úspěšné, Opakované pokusy, nebo Selhalo.

Úspěšné

Udává, že dávka protokolů byla nahrána do vašeho cíle bez chyb nebo vypršení časového limitu. Jakmile se nahrání zdaří, dávka se označí jako doručená a k dalším opakováním již nedochází.

Opakované pokusy

Další pokusy o nahrání provedené po počátečním selhání. Počet zahrnuje i první neúspěšný pokus. Opakované pokusy pokračují, dokud se dávka úspěšně nedoručí, nebo dokud data ve vyrovnávací paměti nezestárnou natolik, že vypadnou z retenčního okna.

Selhalo

Udává, že byly vyčerpány všechny pokusy o nahrání dávky, aniž by se ji podařilo úspěšně nahrát. Když dávka selže, Cloudflare nemůže její protokoly doručit do vašeho cíle a všechny protokoly v dané dávce se zahodí. Tyto protokoly jsou trvale ztraceny.

Postup ve stavovém dashboardu

Stavový dashboard pro Logpush poskytuje dva doplňující se pohledy, které vám pomohou sledovat doručování protokolů a řešit s ním problémy: Stav nahrávání a Spolehlivost nahrávání.

Každé zobrazení zdůrazňuje jiný aspekt výkonu úlohy: co bylo doručeno a jak spolehlivě k doručení došlo.

Stav nahrávání

Stav nahrávání vám pomůže zjistit, kolik dat bylo úspěšně nahráno a kde nahrávání selhalo nebo kde došlo ke ztrátě dat. Toto zobrazení odpovídá na otázku: Probíhá nahrávání úspěšně a dostávají se protokoly do cíle?

Grafy a metriky

Kdy použít

Začněte zde a zjistěte celkový stav doručování dat:

Spolehlivost nahrávání

Spolehlivost nahrávání vám pomáhá identifikovat faktory ovlivňující spolehlivost, stabilitu a latenci u všech pokusů o nahrání (včetně opakování a selhání). Toto zobrazení odpovídá na otázku: Jsou nahrávání stabilní a efektivní?

Grafy a metriky

Kdy použít

Toto zobrazení použijte k řešení problémů se spolehlivostí:

Průvodce řešením potíží

Logpush Health Dashboards vám pomáhají sledovat stav, spolehlivost a výkon vašich úloh Logpush. Tento návod vám pomůže interpretovat jednotlivé grafy, identifikovat hlavní příčinu anomálií a přijmout nápravná opatření.

Název grafu Příznak Co to znamená Možné příčiny Doporučené akce
Úspěch dávkového nahrávání vs. selhání Neúspěšná nahrání Cloudflare se nepodařilo doručit dávky ani po všech pokusech o opakování. Tyto dávky jsou označeny jako failed, a všechny řádky protokolu v nich se zahodí. - Koncový bod cíle je nedostupný nebo odmítá připojení (vypršelé přihlašovací údaje, výpadek).
- Nahrávání vyprší kvůli velkým dávkám nebo latenci sítě.
- Cíl provádí omezování (throttling) nebo rate limiting.
- Ověřte přihlašovací údaje cíle a stav koncového bodu.
- Zmenšete velikost dávky v konfiguraci úlohy Logpush.
- Ověřte, že cíl zvládne očekávanou rychlost nahrávání.
- Pokud chyby přetrvávají, obraťte se na Cloudflare Support.
Nahrané řádky protokolu Zahozené řádky logu nebo snížený objem doručování Je doručováno méně protokolů, než se očekává, často kvůli neúspěšným nahráním nebo zahozeným dávkám. - Nárůst neúspěšných nahrávání.
- Limity příjmu dat na straně cíle nebo částečně nahrané soubory.
- Porovnejte Nahrané řádky protokolu a Objem dat grafy, zda nejsou patrné propady.
- Zkontrolujte, zda se u cíle nevyskytují chyby při příjmu dat nebo rate limiting.
- Zkontrolujte nedávné změny v konfiguraci úlohy Logpush.
Objem dat (komprimovaný a nekomprimovaný) Neočekávaný pokles objemu dat Objem doručených dat je nižší, než se očekávalo, což naznačuje neefektivní kompresi nebo zahozené dávky. - Neúspěšná nahrávání nebo neúplná doručení.
- Cíl odmítá nahrání kvůli limitům velikosti nebo kvóty.
- Zkontrolujte nastavení komprese a velikost dávky.
- Zkontrolujte kapacitu úložiště cíle.
- Zkontrolujte, zda nedochází k nárůstu neúspěšných nahrání nebo opakování.
Nahrané protokoly podle stavového kódu Vysoký počet opakovaných pokusů nebo chybových stavových kódů Nahrávání při prvním pokusu selže, ale při opakování se zdaří. - Dočasný výpadek cíle nebo omezování rychlosti.
- Nestabilita sítě mezi Cloudflare a cílem.
- Zkontrolujte rozložení opakování a selhání podle stavového kódu.
- Porovnejte s Dostupnost cíle pro korelaci.
- Zmenšete velikost dávky.
Opakované pokusy Časté opakované pokusy Nahrávání opakovaně selhává a je vícekrát opakováno. - Nestabilita cíle nebo přechodné chyby.
- Vysoká latence nebo pomalá potvrzení ze strany cíle.
- Ověřte dostupnost cíle a rychlost příjmu dat.
- Ověřte, že cíl požadavky neomezuje (throttling).
- Občasná opakování jsou běžná, trvalé nárůsty je třeba prověřit.
Prům. doba nahrávání Dlouhá doba nahrávání Nahrávání trvá déle, než se očekávalo, což naznačuje latenci nebo příliš velké dávky. - Velké dávky nebo nekomprimovaný obsah.
- Latence sítě nebo regionální latence.
- Zpoždění při zpracování na straně cíle.
- Zkontrolujte Prům. doba nahrávání trendy.
- Zmenšete velikost dávky pro rychlejší nahrávání.
- Zkontrolujte propustnost cíle a nastavení limitu rychlosti.
Dostupnost cíle Nízká nebo nestabilní dostupnost Cloudflare se nemůže spolehlivě připojit k vašemu cíli. - Výpadek cíle, chyby DNS nebo problémy s ověřením.
- Omezení firewallu nebo sítě blokující Cloudflare.
- Zkontrolujte Dostupnost cíle pro propady.
- Ověřte přihlašovací údaje cíle a dostupnost endpointu.
- Zkontrolujte allowlisty nebo nastavení síťového přístupu.

Chybové kódy cíle

Pokud Cloudflare nemůže z vašeho cíle získat kód stavu HTTP (například se spojení nikdy nedokončí nebo je požadavek přerušen), zaznamená se pokus o doručení s chybovým kódem vygenerovaným Cloudflare místo stavu HTTP. Tyto kódy se zobrazují v poli Stavový dashboard a v logpushHealthAdaptiveGroups datová sada GraphQL.

Kód Název Význam
1101 ConnectionError Při připojování Cloudflare k vašemu cíli došlo k síťové chybě, která nebyla způsobena vypršením časového limitu (například resetování TCP spojení nebo odmítnuté připojení).
1102 ConnectionTimeout Cloudflare se nepodařilo navázat TCP spojení s vaším cílem během connection timeout. Obvykle způsobeno firewally, síťovými trasami nebo nedostupnými hostiteli.
1103 InternalLogpushError Cloudflare narazil na interní chybu při zpracování nahrávání. Pokud se tento kód objevuje opakovaně, kontaktujte Cloudflare Support.
1104 ConfigError Konfigurace úlohy je neplatná. Zkontrolujte cílovou adresu URL, přihlašovací údaje a přístupová oprávnění a použijte ověřte koncové body k otestování konfigurace.
1105 DNSError Cloudflare se nepodařilo přeložit název hostitele vašeho cíle. Zkontrolujte DNS záznamy cílového endpointu.
1106 Timeout Požadavek se zastavil nebo překročil celkový časový limit HTTP klienta. Časté v případě, že cíl přijme připojení, ale přestane číst tělo zprávy, nebo když TLS handshake trvá příliš dlouho.
1107 RequestError Požadavek HTTP selhal ještě před vrácením stavového kódu a selhání není klasifikováno jako timeout. Obvykle je způsobeno tím, že cílový server uzavře připojení HTTP/2 uprostřed požadavku.
1108 TransferError Cloudflare narazil na chybu při přenosu těla požadavku. Obvykle to znamená, že bylo spojení během nahrávání resetováno.
1201 FlushMaxLag Cloudflare zahodil dávku, protože data ve vyrovnávací paměti překročila okno uchovávání dříve, než mohla být doručena. Tento kód značí trvalé selhání doručování. Prověřte cíl a předchozí kódy ve stejném časovém rozsahu.

Časové limity nahrávání

Cloudflare uplatňuje několik časových limitů na různých úrovních cesty nahrávání. Pochopení jednotlivých úrovní vám pomůže interpretovat chybové kódy cíle a vyladit svůj cílový koncový bod.

Časový limit Výchozí Platí pro Související chybový kód
Připojení TCP (dial) 5 sekund Všechny cíle využívající HTTP 1102 ConnectionTimeout
TLS handshake 5 sekund Všechny cíle HTTPS 1106 Timeout
Watchdog bez postupu 10 sekund Cíle využívající sdílený HTTP transport Cloudflare (HTTP koncové body, Cloudflare R2, Splunk, Datadog, New Relic, CrowdStrike, Cloudflare Pipelines) 1106 Timeout
Opětovné použití nečinných připojení 10 sekund Trvalá připojení HTTP Nezobrazuje se jako chyba. Připojení se podle potřeby zavře a znovu otevře.
Celkový časový limit klienta HTTP 2 minuty Pouze pro rodinu koncových bodů HTTP: https://, Datadog, New Relic, CrowdStrike, Cloudflare Pipelines 1106 Timeout
Nečinné čtení HTTP/2 a ping 10 sekund nečinnosti, časový limit ping 15 sekund Připojení HTTP/2 1107 RequestError
Zablokování zápisu HTTP/2 10 sekund Připojení HTTP/2 1106 Timeout nebo 1107 RequestError

Pokyny pro provozovatele koncových bodů HTTP

Cíle úložiště objektů

Cíle Amazon S3, Google Cloud Storage a Microsoft Azure nepoužívají sdílený HTTP transport Cloudflare. Používají klientské knihovny, které si nastavují vlastní časové limity, takže se na ně hodnoty z tabulky časových limitů nevztahují. Jednotlivá nahrávání proto mohou před selháním trvat déle než 2 minuty.

Chování při opakování

Logpush je navržen tak, aby dočasné problémy s cílem řešil pomocí automatických opakovaných pokusů. Když je váš cíl dočasně nedostupný, Cloudflare dané dávky uloží do vyrovnávací paměti a pokusí se je znovu doručit.

Opakované pokusy se nezastavují po pevně stanoveném počtu pokusů. Cloudflare místo toho pokračuje v opakovaném odesílání dávky, dokud se nahrání neprovede úspěšně a dávka se neoznačí jako doručená, nebo dokud data ve vyrovnávací paměti nezestárnou natolik, že vypadnou z interního retenčního okna. Jakmile data zestárnou, dávka se zahodí (zaznamenává se jako 1201 FlushMaxLag) a řádky protokolu, které obsahoval, jsou trvale ztraceny.

Pokud se žádná dávka úspěšně nedoručí po dobu 24 hodin, Cloudflare předpokládá, že cíl je trvale nedostupný, a úlohu deaktivuje. Úlohu můžete znovu povolit v Cloudflare dashboard ↗ jakmile se problém s cílem vyřeší. Cloudflare nedokáže doplnit protokoly vygenerované v době, kdy byla úloha zakázána.

Když je cíl pomalý, ale nahrávání stále přijímá, Logpush automaticky zvýší počet paralelních nahrávání, aby zpoždění dohnal. Jakmile se cíl zotaví a zpoždění se vrátí do normálu, souběžnost se opět sníží.