Nápověda a návodyPokročilé monitory › Multi-step / API monitoring

Multi-step / API monitoring

5 min čtení · Pokročilé monitory

Vícekrokové monitorování spustí jako jeden monitor posloupnost HTTP požadavků: přihlásí se, uloží token, použije ho v dalším kroku a ověří odpověď přes JSONPath. Je ideální pro monitorování API a přihlašovacích toků, kde jeden požadavek nestačí. Dostupné v plánech Profi a Business pro HTTP monitory.

Kde to nastavím?

  1. Otevřete detail HTTP monitoru.
  2. V sekci Multi-step / API monitoring vložte JSON seznam kroků a klikněte na Uložit.
  3. Prázdné pole vrátí monitor zpět na klasickou jednoduchou kontrolu.

Formát kroku

Kroky jsou JSON seznam (max 10). Každý krok je objekt s těmito poli:

  • url - adresa kroku (povinné). Může obsahovat proměnnou, např. .
  • method - GET, POST, PUT, PATCH, DELETE, HEAD (výchozí GET).
  • headers - objekt hlaviček (volitelné).
  • body - tělo požadavku jako text (volitelné).
  • expect_status - očekávaný HTTP status (výchozí 200).
  • expect_contains - text, který musí být v odpovědi přítomen.
  • expect_jsonpath + expect_value - cesta v JSON odpovědi a očekávaná hodnota.
  • save - objekt proměnná → JSONPath; hodnota se uloží pro další kroky.
  • name - popisek kroku zobrazený v chybové zprávě (volitelné).

Příklad: přihlášení + ověření

[
  {
    "name": "login",
    "method": "POST",
    "url": "https://api.example.com/auth/login",
    "headers": { "Content-Type": "application/json" },
    "body": "{\"user\": \"demo\", \"pass\": \"...\"}",
    "expect_status": 200,
    "save": { "token": "data.access_token" }
  },
  {
    "name": "profile",
    "url": "https://api.example.com/me",
    "headers": { "Authorization": "Bearer " },
    "expect_jsonpath": "user.active",
    "expect_value": "True"
  }
]

JSONPath

Podporuje tečkovou notaci a indexy polí: data.items[0].id, user.name, volitelný prefix $..

Jak se určuje stav: monitor je Up jen pokud projdou všechny kroky. Při první chybě přejde na Down a chyba uvede číslo a popisek selhavšího kroku. Doba odezvy = součet všech kroků.

Dobré vědět

  • Vícekrokový monitor běží jen z primárního regionu (multiregionální konsenzus se přeskakuje).
  • Cílové adresy nesmí směřovat do interní sítě (stejná ochrana jako u běžných monitorů).
  • Proměnné z save platí pouze v rámci jedné kontroly.
Byl tento návod užitečný?