Multi-step / API monitoring

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

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

Форма нового монітора - вибір типу HTTP, адреса та інтервал
Multi-step налаштовується на HTTP-моніторі (тип обирається під час створення).

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

  1. Відкрийте деталі HTTP-монітора.
  2. У розділі Multi-step / моніторинг API вставте 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": "вхід",
    "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": "профіль",
    "url": "https://api.example.com/me",
    "headers": { "Authorization": "Bearer " },
    "expect_jsonpath": "user.active",
    "expect_value": "True"
  }
]

JSONPath

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

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

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

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