Pomoc i poradniki ›
Zaawansowane 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ę?
- Otwórz stronę szczegółów monitora HTTP.
- W sekcji Multi-step / API monitoring wklej listę kroków w formacie JSON i kliknij Zapisz.
- 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
saveobowiązują tylko w obrębie jednej kontroli.
Czy ten poradnik był pomocny?