Multi-step / API monitoring

5 хв читання · Розширені монітори

Багатокроковий моніторинг виконує як один монітор послідовність HTTP-запитів: виконує вхід, зберігає токен, використовує його на наступному кроці та перевіряє відповідь через JSONPath. Він ідеальний для моніторингу API та процесів входу, коли одного запиту недостатньо. Доступно в планах Pro і Business для HTTP-моніторів.

Де це налаштувати?

  1. Відкрийте сторінку деталей HTTP-монітора.
  2. У розділі Multi-step / API monitoring вставте JSON-список кроків і натисніть Зберегти.
  3. Порожнє поле повертає монітор до класичної одиночної перевірки.

Формат кроку

Кроки - це JSON-список (макс. 10). Кожен крок - це об'єкт із такими полями:

  • url - адреса кроку (обов'язково). Може містити змінну, напр. .
  • method - GET, POST, PUT, PATCH, DELETE, HEAD (за замовчуванням GET).
  • headers - об'єкт заголовків (необов'язково).
  • body - тіло запиту у вигляді тексту (необов'язково).
  • expect_status - очікуваний HTTP-статус (за замовчуванням 200).
  • expect_contains - текст, який має бути присутній у відповіді.
  • expect_jsonpath + expect_value - шлях у JSON-відповіді та очікуване значення.
  • save - об'єкт змінна → JSONPath; значення зберігається для подальших кроків.
  • name - позначка кроку, що відображається в повідомленні про помилку (необов'язково).

Приклад: вхід + перевірка

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

Підтримує крапкову нотацію та індекси масивів: data.items[0].id, user.name, необов'язковий префікс $..

Як визначається статус: монітор має статус Up лише якщо всі кроки пройдено. За першої помилки він переходить у Down а в помилці зазначається номер і позначка кроку, що не вдався. Час відповіді = сума всіх кроків.

Корисно знати

  • Багатокроковий монітор виконується лише з основного регіону (мультирегіональний консенсус пропускається).
  • Цільові адреси не повинні вказувати на внутрішню мережу (той самий захист, що й у звичайних моніторів).
  • Змінні з save дійсні лише в межах однієї перевірки.
Чи був цей посібник корисним?