INTEGRITY Dokumentace

Oznámení monitoru stavu

Cloudflare migruje oznámení používaná v rámci load balancingu monitory stavu k použití centralizovaného Služba Notifications.

Co se mění a proč?

Cloudflare na úrovni účtu Služba Notifications je nyní centrálním místem pro většinu služeb Cloudflare. Tato změna přináší jednotnost a zjednodušenou správu a zároveň vám dává více možností doručování oznámení, například konfiguraci webhooků nebo přiřazení více poolů ke stejnému oznámení. Tato nová oznámení se navíc spravují na úrovni účtu, nikoli na úrovni zóny.

Důrazně doporučujeme všem zákazníkům, aby migrovali stávající oznámení Health Monitor na centralizovanou Notifications Service společnosti Cloudflare, a předešli tak výpadkům upozornění.

Průvodce migrací

Podle tohoto návodu byste měli přejít na all vaše stávající oznámení monitoru stavu.

Krok 1: Vyhledání existujících upozornění

Nejprve zjistěte, které pooly používají oznámení. Často je jednodušší použít Cloudflare API k výpisu všech poolů a vyhledat notification_email .

S kódem

Použijte Cloudflare API k výpisu všech vašich poolů a poté zkontrolujte, zda má každý pool vyplněnou hodnotu pro notification_email .

Požadavek
curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/load_balancers/pools" \
--header "Authorization: Bearer <API_TOKEN>" \
| jq '[.result[] | select(.notification_email != "") | {name, notification_email}]'
Odpověď
[
    {
        "name": "pool-1",
        "notification_email": "[email protected]"
    },
    {
        "name": "pool-2",
        "notification_email": "[email protected]"
    },
    {
        "name": "pool-3",
        "notification_email": "[email protected]"
    },
    {
        "name": "pool-4",
        "notification_email": "[email protected]"
    }
]

Žádný kód

Chcete-li v dashboardu vyhledat pooly s existujícími upozorněními:

  1. Přihlaste se do Cloudflare dashboard ↗ a vyberte svůj účet a doménu.
  2. Přejděte na Load Balancing.
  3. Vyberte Fondy kartě.
  4. U poolu vyberte Úprava.
  5. Pro Oznámení o kontrolách stavu, zkontrolujte, že je hodnota přepnuta na On a e-mailová adresa je uvedena v E-mailová adresa pro oznámení .

Krok 2: Vytvoření nových upozornění

V tomto kroku byste měli vytvořit nová oznámení, která nahradí všechna vaše stávající zastaralá oznámení.

S kódem

Pokud používáte Cloudflare API, znovu vytvořte všechna svá stávající oznámení s následujícími zadanými parametry:

"alert_type": "load_balancing_health_alert",
"filters": {
    "pool_id": <<ARRAY_OF_INCLUDED_POOL_IDS>>,
    "new_health": <<ARRAY_OF_STATUS_TRIGGERS>> ["Unhealthy", "Healthy"],
    "event_source": <<ARRAY_OF_OBJECTS_WATCHED>> ["pool", "origin"]
}

Žádný kód

U poolu, který jste našli v Krok 1, vyhledejte Oznámení pro pool. Klikněte na Vytvoření Health Alert ke spuštění vytvoření oznámení.

Krok 3: Odstranění zastaralých upozornění

Jako poslední krok migračního procesu musíte odstranit všechny e-maily ze svých starších notifikací, abyste do budoucna nedostávali e-maily o ukončení podpory.

Tyto kroky lze provést i v dashboardu, Cloudflare ale pro větší pohodlí doporučuje použít nový API endpoint.

S kódem

Pokud používáte Cloudflare API, nedávno jsme přidali PATCH koncový bod, díky čemuž můžete snadno zrušit e-mailová oznámení pro více poolů najednou.

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
Patch Pools
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/load_balancers/pools" \
	--request PATCH \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"notification_email": ""
	}'

Toto volání API podporuje standardní parametry dotazu pro stránkování, buď limit/offset nebo per_page/page, proto ve výchozím nastavení aktualizuje pouze prvních 25 uvedených poolů. Aby se aktualizovaly všechny vaše pooly, možná budete muset upravit volání API tak, aby procházelo různé stránky nebo aby každý požadavek zahrnoval větší počet poolů.

V případě potřeby můžete starší oznámení odebrat pomocí dashboardu.

Žádný kód

Jakmile vytvoříte nové oznámení v Krok 2, vrátíte se do poolu, který jste předtím upravovali. Chcete-li zastaralá oznámení vypnout, musíte z pole odebrat všechny e-mailové adresy pro oznámení.

Pokud tento krok nedokončíte (odebrání všech e-mailů s oznámeními ze všech poolů), vaše migrace nebude považována za dokončenou a budete i nadále dostávat další e-maily o tomto ukončení podpory.