INTEGRITY Dokumentace

Běžné chybové kódy

Cloudflare Load Balancing API přidává ke každému poolu a endpointu globální stav. Zároveň vám umožňuje nahlédnout, jak provoz vidí naše síť v širším měřítku. Cloudflare k určení stavu poolu a endpointu používá systém kvora. Kvorum se tvoří z PoPs, které v dané oblasti odpovídají za odesílání požadavků health monitoru, a použije se výsledek většiny.

Při řešení potíží využijte Cloudflare API pro programový přístup ke Cloudflare Load Balancing. Trasy Health Monitor Events a Load Balancer Monitors jsou skvělým nástrojem pro přístup k protokolům událostí load balancingu a pro rekonfiguraci monitorů Cloudflare.

Rozpis stavu vašich endpointů po jednotlivých datových centrech můžete získat z Cloudflare API pomocí příkazu List Health Monitor Events:

GET user/load_balancing_analytics/events

Pokud požadavek monitoru stavu selže, rozpis bude obsahovat důvod.

Níže jsou uvedeny běžné příčiny problémů a jejich řešení.


TCP connection failed

Příčina

Požadavkům našeho monitoru stavu se nepodařilo navázat TCP připojení k vašemu koncovému bodu.

Řešení

K tomu obvykle dochází při výpadku sítě mezi Cloudflare a vaším endpointem, případně když firewall odmítne naše připojení. Zkontrolujte, že konfigurace sítě a firewallu nebrání provozu load balancingu.


HTTP timeout occurred

Příčina

Koncový bod nevrátil odpověď HTTP ve stanoveném časovém limitu. K tomu dochází, pokud máte časový limit nastavený na nízkou hodnotu, například na 1 nebo 2 sekundy.

Řešení

Doporučujeme zvýšit časový limit odpovědi HTTP, aby endpoint měl čas odpovědět.


Chyba neshody kódu odpovědi

Příčina

Cloudflare obdrží stavový kód HTTP, který neodpovídá hodnotám definovaným v expected_codes vlastnost konfigurace vašeho monitoru Cloudflare.

Řešení

Kódy odpovědi musí odpovídat expected_codes. Pomocí příkazu API List Monitors ověřte, že jsou hodnoty správné.

Alternativní příčina

Tento problém se může projevit i v případě, že máte monitor nakonfigurovaný na použití HTTP připojení a váš endpoint přesměrovává na HTTPS. V takovém případě bude kód odpovědi často 301, 302 nebo 303.

Řešení

Buď změňte konfiguraci monitoru Cloudflare tak, aby používala HTTPS, nebo nastavte hodnotu follow_redirect na true abychom mohli určit správný stavový kód.


Chyba neshody těla odpovědi

Příčina

Tělo odpovědi vrácené z vašeho koncového bodu neobsahuje hodnotu (bez rozlišení velkých a malých písmen) expected_body nakonfigurovaný ve vašem monitoru.

Upozorňujeme, že se čte pouze prvních 10 KB odpovědi. Pokud vrátíte delší odpověď a řetězec expected_body se v prvních 10 KB nenachází, požadavek monitoru stavu selže.

Řešení

Ujistěte se, že se expected_body nachází v prvních 10 KB těla odpovědi.


TLS untrusted certificate error

Příčina

Certifikátu nedůvěřuje žádná veřejná certifikační autorita (CA).

Řešení

Pokud používáte certifikát podepsaný svým držitelem, doporučujeme buď použít veřejně důvěryhodný certifikát, nebo nastavit allow_insecure vlastnost svého monitoru na true.


TLS name mismatch error

Příčina

Náš monitor stavu (klient) nedokázal spárovat název na certifikátu serveru s názvem hostitele požadavku.

Řešení

Pomocí příkazu List Monitors ověřte, že header hodnota nastavená v monitoru Cloudflare je správná, a případné potřebné změny proveďte pomocí příkazu Update Monitors.


TLS protocol error

Příčina

Tato chyba může nastat, pokud používáte starší verzi TLS, nebo pokud váš endpoint nemá nakonfigurované HTTPS.

Řešení

Ujistěte se, že váš endpoint podporuje TLS 1.0 nebo vyšší a je nakonfigurován pro HTTPS.


TLS unrecognized name error

Příčina

Server nerozpoznal název poskytnutý klientem. Pokud je nastavena hlavička hostitele, použije se jako ServerName v úvodním TLS handshake. Pokud nastavena není, ServerName se neposkytne, což může tuto chybu způsobit.

Řešení

Nastavte hlavičku host v objektu monitoru.


Chyba No route to host

Příčina

IP adresu nelze z naší sítě dosáhnout. Mezi běžné příčiny patří problémy v síti poskytovatele internetu (ISP) nebo hostingu (například na úrovni BGP), případně skutečnost, že daná IP adresa neexistuje.

Řešení

Ověřte, že je IP adresa správná, a pokud ano, zkontrolujte, zda nejde o problém v síti poskytovatele internetu nebo hostingu.


Chyba překročení kvóty

Příčina

Tuto chybu obdržíte, pokud se pokusíte vytvořit více objektů (monitorů, poolů nebo endpointů), než kolik jich váš plán zahrnuje.

Pokud používáte dashboard, nebudete moci vytvářet další objekty.

Pokud používáte Cloudflare API, zobrazí se vám chybová zpráva.

Řešení


TCP Timeout

Příčina

Přenos dat nebyl potvrzen a opakovaný přenos dat se nezdařil.

Řešení

Ověřte, zda k SYN-ACK segmentu handshaku dochází na vašem endpointu a kontaktujte Cloudflare Support.


TLS Handshake Failure

Příčina

Znamená, že připojení prohlížeče k webovému serveru není zabezpečené.

Řešení

Změňte síť wifi, připojte se ke kabelové síti nebo ověřte, že je síťové připojení stabilní.


Síť je nedostupná

Příčina

Cloudflare se nemůže připojit k endpointu kvůli nedostupnosti sítě. Obvykle to způsobuje problém se sítí nebo nesprávná IP adresa.

Řešení

Zkontrolujte buď IP adresu zadanou pro endpoint v konfiguraci Cloudflare Load Balanceru, nebo IP adresu vrácenou přes DNS pro hostname endpointu.


HTTP Invalid Response

Příčina

Obvykle je to způsobeno chybou HTTP 502 nebo bad gateway.

Řešení

Ujistěte se, že endpoint odpovídá na požadavky a že žádné aplikace nespadly ani nejsou přetížené.


DNS Unknown Host

Příčina

Název hostitele koncového bodu neexistuje.

Řešení

Ověřte, že se endpoint překládá na IP adresu.


Connection Reset by Peer

Příčina

Při příjmu dat z endpointu klientem došlo k síťové chybě.

Řešení

Ověřte, zda endpoint nezaznamenává vysoký objem provozu nebo chybu.


Chyba konfigurace monitoru

Příčina

V konfiguraci monitoru došlo k chybě, a proto se u koncových bodů poolu neprovádí žádné kontroly.

Řešení

Zkontrolujte konfiguraci monitoru a ověřte, že odpovídá očekávanému požadavku na váš koncový bod.


DNS Internal

Příčina

Název hostitele koncového bodu se překládá na interní IP adresu nebo IP adresu s aktivním proxy (oranžový cloud). Vůči koncovým bodům fondu se neprovádí žádné kontroly.

Řešení

Cloudflare nepovoluje, aby hostname endpointu byl proxovaný přes Cloudflare.


Load Balancing není povoleno

Příčina

Load Balancing není povoleno pro váš účet ani zónu.

Řešení

Pokud jste zákazníkem s plánem Enterprise, obraťte se na svůj Cloudflare Account Team. Pokud máte plán Free, Pro nebo Business, měli byste Povolit Load Balancing.


Chyba selhání ověření

Příčina

Pokud se při konfiguraci endpointu load balanceru pokusíte nastavit hodnotu hlavičky hostitele, zobrazí se chyba.

Řešení

Cloudflare nyní omezuje nakonfigurované hostitelské hlavičky koncových bodů na plně kvalifikované doménové názvy (FQDN), které jsou přímými subdoménami zóny přiřazené k účtu. Tato hlavička hostitele by například patř ila do stejné zóny jako samotný load balancer, pooly však lze používat napříč více load balancery.


Objekt odkazovaný jinými objekty

Příčina

Tuto chybu obdržíte, když se pokusíte odstranit pool, na který odkazuje load balancer geografické směrování region.

Řešení

Odstraňte pool z konfigurace geografického směrování load balanceru. Pokud váš load balancer geografické směrování již nepoužívá, budete muset znovu povolte geografické směrování a poté pool odeberte.


Jiné selhání

Příčina

Pokud selhání nelze zařadit do žádného z výše uvedených typů selhání.

Řešení

Kontaktujte podporu Cloudflare.