INTEGRITY Dokumentace

Správa monitorů

Monitor v pravidelných intervalech odesílá kontrolní požadavky, aby vyhodnotil stav každého koncového bodu v rámci pool.

Když pool stane se nedostupným, load balancer daný pool vyřadí z rotace koncových bodů.

Podrobnosti o monitorech najdete v Monitory.


Časování opakování

Když vyprší časový limit kontroly stavu, Cloudflare okamžitě odešle opakované pokusy. Nečeká na další interval. Časový limit retries nastavení určuje počet dalších pokusů po počáteční kontrole. Například u pěti opakování:


Vytvořte monitor

Nastavení monitoru

Monitor můžete vytvořit v pracovní postup load balanceru nebo v Monitory kartě:

  1. Přejděte na Load Balancing.

  2. Vyberte Monitory kartě.

  3. Vyberte Vytvoření monitoru.

  4. Přidejte následující informace:

    • Typ: Protokol, který se má použít pro monitory
      • Zákazníci mimo plán Enterprise: Vyberte HTTP, HTTPS, nebo TCP.
      • Zákazníci s plánem Enterprise: Vyberte HTTP, HTTPS, TCP, UDP ICMP, ICMP Ping, nebo SMTP.
    • Cesta: Cesta endpointu, na kterou se odesílají požadavky monitoru
    • Port: Cílový port pro monitory

  5. Pro další nastavení vyberte Pokročilá nastavení monitoru stavu:

    • Interval:
      • Zvýšením výchozí hodnoty můžete zlepšit dobu failoveru, ale zároveň můžete zvýšit zátěž svých endpointů.
      • Minimální čas v sekundách je 60 (Pro), 15 (Business) a 10 (Enterprise).
    • Časový limit a Opakování:
      • Požadavek monitoru stavu se vyhodnotí jako nedostupný, pokud překročí dobu trvání zadanou v Časový limit (a tuto dobu překročí vícekrát, než je zadaný počet Opakování).
    • Očekávaný kód (kódy): Očekávané kódy odpovědi HTTP uvedené jednotlivě (200, 302) nebo jako rozsah (například zadáním 2xx by pokrylo všechny kódy odpovědí v 200 rozsah).
    • Tělo odpovědi:
      • Hledá podřetězec bez rozlišování velkých a malých písmen v těle odpovědi.
      • Ověřte, že je hodnota poměrně stálá a nachází se v prvních 10 KB stránky HTML.
    • Simulate Zone:
    • Follow Redirects:
      • Namísto hlášení 301 nebo 302 kód jako nezdravý, požadavek health monitoru sleduje přesměrování až na konečný endpoint.
    • Nakonfigurujte hlavičky požadavku:
      • Užitečné, pokud vaše endpointy očekávají konkrétní příchozí hlavičky.
    • Hlavička:
      • HTTP hlavičky požadavku, které se mají odeslat v rámci health monitoru. Ve výchozím nastavení doporučujeme nastavit hlavičku Host. Hlavičku User-Agent nelze přepsat. Tento parametr platí pouze pro monitory typu HTTP a HTTPS.

  6. Vyberte Save.

Připravte své servery

Ověřte, že váš firewall nebo webový server neblokuje ani neomezuje četnost vašich nakonfigurovaných monitorů stavu nebo požadavků souvisejících s IP adresy Cloudflare ↗.

Každý monitor stavu používá HTTP user-agent "Mozilla/5.0 (compatible; Cloudflare-Traffic-Manager/1.0; +https://www.cloudflare.com/traffic-manager/; pool-id: $poolid)", kde $poolid je prvních 16 znaků přidružený fond.

Připojte monitor k poolu

Jakmile je monitor vytvořený, musíte ho připojit k poolu:

  1. Přejděte na Load Balancing.

  2. Vyberte Fondy kartě.

  3. U konkrétního poolu vyberte Úprava.

  4. Aktualizujte následující informace:

    • Sledovat: Vyberte svůj monitor.
    • Regiony monitoru stavu: Určuje geografické oblasti, ze kterých má Cloudflare odesílat požadavky health monitoru. Vzhledem k jak monitory kontrolují stav fondu, výběr více regionů může zvýšit zátěž vašich serverů.
    • E-mail pro oznámení: Obsahuje e-mailové adresy, na které se odesílají oznámení (adresa jednotlivce, adresa e-mailové konference, adresa PagerDuty).
  5. Vyberte Save. Stav vašeho monitoru stavu bude unknown dokud nejsou k dispozici výsledky první kontroly.

Nastavení monitoru

Úplný seznam vlastností monitoru najdete v Vytvoření monitoru. Pokud potřebujete pomoc s ověřováním API, viz Dokumentace Cloudflare API.

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Load Balancing: Monitors and Pools Write
Vytvoření monitoru
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/load_balancers/monitors" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"type": "https",
		"description": "Login page monitor",
		"method": "GET",
		"path": "/health",
		"header": {
				"Host": [
						"example.com"
				],
				"X-App-ID": [
						"abc123"
				]
		},
		"port": 8080,
		"timeout": 3,
		"retries": 0,
		"interval": 90,
		"expected_body": "alive",
		"expected_codes": "2xx",
		"follow_redirects": true,
		"allow_insecure": true,
		"consecutive_up": 3,
		"consecutive_down": 2,
		"probe_zone": "example.com"
	}'

Odpověď obsahuje úplnou definici nového monitoru.

Odpověď
{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "id": ":monitor-id",
    "created_on": "2021-01-01T05:20:00.12345Z",
    "modified_on": "2021-01-01T05:20:00.12345Z",
    "type": "https",
    "description": "Login page monitor",
    "method": "GET",
    "path": "/health",
    "header": {
      "Host": [
        "example.com"
      ],
      "X-App-ID": [
        "abc123"
      ]
    },
    "port": 8080,
    "timeout": 3,
    "retries": 0,
    "interval": 90,
    "expected_body": "alive",
    "expected_codes": "2xx",
    "follow_redirects": true,
    "allow_insecure": true,
    "consecutive_up": 3,
    "consecutive_down": 2,
    "probe_zone": "example.com"
  }
}

Připravte své servery

Ověřte, že váš firewall nebo webový server neblokuje ani neomezuje četnost vašich nakonfigurovaných monitorů stavu nebo požadavků souvisejících s IP adresy Cloudflare ↗.

Každý monitor stavu používá HTTP user-agent "Mozilla/5.0 (compatible; Cloudflare-Traffic-Manager/1.0; +https://www.cloudflare.com/traffic-manager/; pool-id: $poolid)", kde $poolid je prvních 16 znaků přidružený fond.

Připojte monitor k poolu

Jakmile je monitor vytvořený, uložte jeho id vlastnost. Tuto hodnotu zahrňte do monitor parametr, když vytvoření vašeho fondu.


Úprava monitoru

Úprava monitoru v dashboardu:

  1. Přejděte na Load Balancing.
  2. Vyberte Monitory.
  3. U konkrétního monitoru vyberte Úprava.
  4. Podle potřeby aktualizujte nastavení.
  5. Vyberte Save.

Když upravujete monitor pomocí API, typ požadavku závisí na tom, jak velký rozsah úprav chcete provést.

Chcete-li aktualizovat konkrétní nastavení, aniž byste museli znovu odesílat celou konfiguraci, použijte PATCH požadavek. Pro rozsáhlejší změny použijte PUT požadavek.


Odstranění monitoru

Odstranění monitoru v dashboardu:

  1. Přejděte na Load Balancing.
  2. Vyberte Monitory kartě.
  3. U konkrétního monitoru vyberte Smazat.

Monitor odstraníte přes API odesláním požadavku DELETE požadavek.