Ключевые слова в HTTP-мониторах
Утверждения по ключевым словам позволяют убедиться, что HTTP-монитор получает ожидаемое содержимое ответа — в дополнение к проверке HTTP-статуса. Даже если сервер вернул код 200 OK, страница может быть пустой, содержать сообщение об ошибке или отдавать техническую заглушку. Ключевые слова выявляют такие ситуации автоматически.
Функция доступна на тарифах Starter и выше
Типы утверждений
Для каждого утверждения выбирается один из трёх типов:
contains— содержит- UpRadar создаёт инцидент, если заданная подстрока не найдена в теле ответа. Используйте этот тип, чтобы убедиться, что конкретная фраза, статус или JSON-поле присутствуют в ответе.
not_contains— не содержит- UpRadar создаёт инцидент, если заданная подстрока найдена в теле ответа. Используйте этот тип, чтобы обнаружить страницы технического обслуживания, сообщения об ошибках или нежелательный контент.
jsonpath— JSONPath-выражение- Вычисляет JSONPath-выражение относительно тела ответа. Инцидент создаётся, если выражение не возвращает ни одного совпадения. Используйте для точечной проверки конкретных полей JSON без поиска по всей строке ответа.
Настройка
- Откройте настройки нужного HTTP-монитора.
- Перейдите в раздел «Утверждение тела ответа».
- Выберите тип:
contains,not_containsилиjsonpath. - Введите ключевое слово или JSONPath-выражение в соответствующее поле.
- Сохраните настройки — проверка вступит в силу при следующей итерации монитора.
Пример: типичный health-endpoint JSON-сервиса, где нужно убедиться в успешном статусе:
{"status":"ok","db":"connected"} Задайте ключевое слово "status":"ok" в режиме «Должно присутствовать» — и монитор сообщит о проблеме, если база данных недоступна или сервис вернёт "status":"degraded".
Практические примеры
1. Проверка health-endpoint
Ключевое слово:"status":"ok" • Режим: присутствует
Убедитесь, что API возвращает признак успешного состояния, а не только HTTP 200.
2. Обнаружение страницы техобслуживания
Ключевое слово:Технические работы • Режим: отсутствует
Фиксируйте инцидент, если пользователи видят заглушку вместо боевого сайта.
3. Контроль редиректа на страницу входа
Ключевое слово:login • Режим: отсутствует
Если защищённый раздел перестаёт требовать авторизацию, это тоже инцидент.
Совет. Проверка ключевых слов выполняется только для успешных HTTP-запросов. Если монитор не получил ответ из-за таймаута или сетевой ошибки, инцидент будет создан независимо от настроек ключевых слов.