Pomoc i poradnikiZaawansowane monitory › Multi-step / API monitoring

Multi-step / API monitoring

5 min czytania · Zaawansowane monitory

Monitorowanie wieloetapowe uruchamia jako jeden monitor sekwencję żądań HTTP: loguje się, zapisuje token, używa go w kolejnym kroku i weryfikuje odpowiedź przez JSONPath. Jest idealne do monitorowania API i procesów logowania, gdy jedno żądanie nie wystarcza. Dostępne w planach Pro i Business dla monitorów HTTP.

Gdzie to ustawię?

  1. Otwórz stronę szczegółów monitora HTTP.
  2. W sekcji Multi-step / API monitoring wklej listę kroków w formacie JSON i kliknij Zapisz.
  3. Puste pole przywraca monitor do klasycznej pojedynczej kontroli.

Format kroku

Kroki to lista JSON (maks. 10). Każdy krok jest obiektem z tymi polami:

  • url - adres kroku (wymagane). Może zawierać zmienną, np. .
  • method - GET, POST, PUT, PATCH, DELETE, HEAD (domyślnie GET).
  • headers - obiekt nagłówków (opcjonalnie).
  • body - treść żądania jako tekst (opcjonalnie).
  • expect_status - oczekiwany status HTTP (domyślnie 200).
  • expect_contains - tekst, który musi znajdować się w odpowiedzi.
  • expect_jsonpath + expect_value - ścieżka w odpowiedzi JSON i oczekiwana wartość.
  • save - obiekt zmienna → JSONPath; wartość jest zapisywana do kolejnych kroków.
  • name - etykieta kroku wyświetlana w komunikacie o błędzie (opcjonalnie).

Przykład: logowanie + weryfikacja

[
  {
    "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

Obsługuje notację z kropką i indeksy tablic: data.items[0].id, user.name, opcjonalny prefiks $..

Jak ustalany jest status: monitor jest Up tylko gdy wszystkie kroki przejdą. Przy pierwszym niepowodzeniu przechodzi w stan Down a błąd podaje numer i etykietę kroku, który zawiódł. Czas odpowiedzi = suma wszystkich kroków.

Warto wiedzieć

  • Monitor wieloetapowy działa tylko z regionu podstawowego (konsensus wieloregionowy jest pomijany).
  • Adresy docelowe nie mogą wskazywać na sieć wewnętrzną (ta sama ochrona co w zwykłych monitorach).
  • Zmienne z save obowiązują tylko w obrębie jednej kontroli.
Czy ten poradnik był pomocny?