Руководство UpRadar — все разделы

Ключевые слова в HTTP-мониторах

Утверждения по ключевым словам позволяют убедиться, что HTTP-монитор получает ожидаемое содержимое ответа — в дополнение к проверке HTTP-статуса. Даже если сервер вернул код 200 OK, страница может быть пустой, содержать сообщение об ошибке или отдавать техническую заглушку. Ключевые слова выявляют такие ситуации автоматически.

Функция доступна на тарифах Starter и выше.

Типы утверждений

Для каждого утверждения выбирается один из трёх типов:

  • contains — содержит UpRadar создаёт инцидент, если заданная подстрока не найдена в теле ответа. Используйте этот тип, чтобы убедиться, что конкретная фраза, статус или JSON-поле присутствуют в ответе.
  • not_contains — не содержит UpRadar создаёт инцидент, если заданная подстрока найдена в теле ответа. Используйте этот тип, чтобы обнаружить страницы технического обслуживания, сообщения об ошибках или нежелательный контент.
  • jsonpath — JSONPath-выражение Вычисляет JSONPath-выражение относительно тела ответа. Инцидент создаётся, если выражение не возвращает ни одного совпадения. Используйте для точечной проверки конкретных полей JSON без поиска по всей строке ответа.

Настройка

  1. Откройте настройки нужного HTTP-монитора.
  2. Перейдите в раздел «Утверждение тела ответа».
  3. Выберите тип: contains, not_contains или jsonpath.
  4. Введите ключевое слово или JSONPath-выражение в соответствующее поле.
  5. Сохраните настройки — проверка вступит в силу при следующей итерации монитора.

Пример: типичный health-endpoint JSON-сервиса, где нужно убедиться в успешном статусе:

{"status":"ok","db":"connected"}

Задайте ключевое слово "status":"ok" в режиме «Должно присутствовать» — и монитор сообщит о проблеме, если база данных недоступна или сервис вернёт "status":"degraded".

Практические примеры

1. Проверка health-endpoint

  • Ключевое слово: "status":"ok"
  • Режим: присутствует

Убедитесь, что API возвращает признак успешного состояния, а не только HTTP 200.

2. Обнаружение страницы техобслуживания

  • Ключевое слово: Технические работы
  • Режим: отсутствует

Фиксируйте инцидент, если пользователи видят заглушку вместо боевого сайта.

3. Контроль редиректа на страницу входа

  • Ключевое слово: login
  • Режим: отсутствует

Если защищённый раздел перестаёт требовать авторизацию, это тоже инцидент.

Совет. Проверка ключевых слов выполняется только для успешных HTTP-запросов. Если монитор не получил ответ из-за таймаута или сетевой ошибки, инцидент будет создан независимо от настроек ключевых слов.