← Cloudflare Magic Transit / magic-transit / network-health

Spusťte kontroly stavu koncových bodů (beta)

Magic Transit využívá kontroly stavu koncových bodů ke zjištění celkového stavu vaší mezisíťová propojení. Sondy vycházejí z infrastruktury Cloudflare, mimo síťové jmenné prostory zákazníka, a míří na IP adresy hluboko uvnitř vaší sítě, za hraničním routerem, kde tunel končí. Tyto sondy „na dálku“ slouží čistě k diagnostice.

Při výběru IP adres koncových bodů, které chcete sledovat pomocí kontrol stavu, se řiďte těmito pokyny:

• Pro každý prefix, který Cloudflare inzeruje, zadejte jednu IP adresu.
• Redundantní IP adresy směrované přes stejného ISP (Internet Service Provider) a stejnou infrastrukturu nejsou nutné, ale hodí se při řešení problémů.

Cloudflare odesílá pingy na IP adresy kontrol stavu zevnitř zveřejněný rozsah IP adres Cloudflare ↗, což je dostupné také prostřednictvím Cloudflare API.

Při konfiguraci kontroly stavu koncového bodu pro prefix IP vyberte IP adresu z rozsahu tohoto prefixu. Příklad konfigurace kontroly stavu koncového bodu najdete v tabulce.

Viz Tunnel health checks s dalšími informacemi.

Kontroly stavu koncových bodů lze nastavit pouze přes Cloudflare API, v dashboardu tato možnost není k dispozici. Konfigurace kontrol stavu je v současnosti funkcí ve fázi beta.

Viz Dokumentace API se dozvíte, jak vytvářet, vypisovat a mazat kontroly stavu koncových bodů. Následující příklad vytváří novou kontrolu stavu koncového bodu.

curl "https://api.cloudflare.com/client/v4/accounts/account_id/diagnostics/endpoint-healthchecks" \
	--request POST \
	--json '{
		"check_type": "icmp",
		"endpoint": "8.31.160.1",
		"name": "Datacenter 1 - primary"
	}'

{
    "result": {
        "id": "<HEALTH_CHECK_ID>",
        "check_type": "icmp",
        "endpoint": "8.31.160.1",
        "name": "Datacenter 1 - primary"
    },
    "success": true,
    "errors": [],
    "messages": []
}

Použijte GraphQL Analytics API k dotazování na výsledky kontrol stavu koncových bodů pro váš účet. magicEndpointHealthCheckAdaptiveGroups dataset vrací výsledky sond agregované podle dimenzí a časového intervalu, které zadáte.

Všechny dotazy GraphQL odesílejte jako HTTP POST požadavky na https://api.cloudflare.com/client/v4/graphql.

K dotazování dat kontrol stavu koncových bodů potřebujete následující:

• Váš ID účtu.
• API token hodnotou Account > Account Analytics > Read oprávnění. Podrobnosti najdete v Nakonfigurujte token Analytics API.

Následující parametry patří mezi nejběžnější v filter objekt:

Filtrovat můžete také podle libovolné dimenze uvedené v Dostupné dimenze tabulku. Filtr vytvoříte připojením přípony operátoru k názvu dimenze, například endpoint_in k filtrování podle seznamu koncových bodů, nebo checkType_neq k vyloučení konkrétního typu kontroly. Použití názvu dimenze bez přípony filtruje podle rovnosti. Úplný seznam podporovaných operátorů najdete v Filtrování.

Následující dimenze můžete dotazovat v dimensions pole:

Následující příklad dotazuje výsledky kontrol stavu koncových bodů pro konkrétní účet a vrací počty sond agregované v pětiminutových intervalech. Nahraďte <ACCOUNT_ID> s vaším ID účtu a <API_TOKEN> s vaším API token.

echo '{ "query":
  "query GetEndpointHealthCheckResults($accountTag: string, $datetimeStart: string) {
    viewer {
      accounts(filter: {accountTag: $accountTag}) {
        magicEndpointHealthCheckAdaptiveGroups(
          filter: {
            datetime_geq: $datetimeStart
          }
          limit: 10
        ) {
          count
          dimensions {
            checkId
            checkType
            endpoint
            datetimeFiveMinutes
          }
          sum {
            failures
            total
          }
        }
      }
    }
  }",
  "variables": {
    "accountTag": "<ACCOUNT_ID>",
    "datetimeStart": "2026-01-21T00:00:00Z"
  }
}' | tr -d '\n' | curl --silent \
https://api.cloudflare.com/client/v4/graphql \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data @-

Výstup přesměrujte rourou do jq k naformátování odpovědi JSON pro snazší čtení:

... | curl --silent \
https://api.cloudflare.com/client/v4/graphql \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data @- | jq .

{
  "data": {
    "viewer": {
      "accounts": [
        {
          "magicEndpointHealthCheckAdaptiveGroups": [
            {
              "count": 288,
              "dimensions": {
                "checkId": "90b478c7-bb51-4640-b94b-2c3050e9fa00",
                "checkType": "icmp",
                "datetimeFiveMinutes": "2026-01-21T12:00:00Z",
                "endpoint": "103.21.244.100"
              },
              "sum": {
                "failures": 0,
                "total": 288
              }
            },
            {
              "count": 288,
              "dimensions": {
                "checkId": "90b478c7-bb51-4640-b94b-2c3050e9fa00",
                "checkType": "icmp",
                "datetimeFiveMinutes": "2026-01-21T12:05:00Z",
                "endpoint": "103.21.244.100"
              },
              "sum": {
                "failures": 2,
                "total": 288
              }
            }
          ]
        }
      ]
    }
  },
  "errors": null
}

V této odpovědi sum.total je počet sond odeslaných během intervalu a sum.failures je počet těch, které nedostaly odpověď. failures hodnotu 0 značí, že endpoint byl po celé toto období plně dostupný.

Můžete si nastavit upozornění, která vás informují, jakmile stav vašeho koncového bodu klesne pod vámi zvolenou hranici.

1. Vytvořte GET požadavek, kterým získáte seznam ID všech nakonfigurovaných kontrol stavu koncových bodů:

curl "https://api.cloudflare.com/client/v4/accounts/account_id/diagnostics/endpoint-healthchecks" \
	--request GET

{
    "result": [
        {
            "id": "<HEALTH_CHECK_ID>",
            "check_type": "icmp",
            "endpoint": "8.31.160.1",
            "name": "Datacenter 1 - primary"
        }
    ],
    "success": true,
    "errors": [],
    "messages": []
}

2. Poznamenejte si id hodnotu koncového bodu, pro který chcete dostávat upozornění.
3. V dashboardu Cloudflare přejděte na Oznámení stránce.

4. Vyberte Přidat.
5. V rozbalovací nabídce vyberte Magic Transit.
6. Vyberte Magic Endpoint Health Check Alert.
7. Zadejte název nové notifikace a volitelně přidejte i popis.
8. V Cíl úrovně služby (SLO) rozbalovací nabídce vyberte prahovou hodnotu SLO pro své upozornění. SLO určuje procento kontrol stavu koncových bodů, které musí projít. Pokud počet úspěšných kontrol stavu koncových bodů klesne pod tuto hodnotu, Cloudflare vygeneruje upozornění:
   • Vysoká - 99%
   • Medium - 98%
   • Low - 97%
9. V rozevírací nabídce pod SLOs vyberte id hodnotu, která odpovídá id které jste získali přes API v kroku 1. Tato id by mělo odpovídat kontrole stavu koncového bodu, pro kterou chcete dostávat upozornění.
10. Vyberte preferovaný způsob oznamování (například e-mail nebo webhooky).
11. Vyberte Save.

Nyní budete zvoleným způsobem dostávat upozornění pokaždé, když SLO vašich kontrol stavu koncových bodů klesne pod zvolenou hranici.