Если у вас есть набор интеграционных тестов для внутреннего тестирования API с помощью Insomnia, вы можете загрузить свои коллекции тестов Insomnia в Dotcom-Monitor для тестирования API из 40+ глобальных локаций.

Dotcom-Monitor поддерживает различные опции, такие как оповещение об ошибках, возникающих при мониторинге, указание мест мониторинга, а также настройка планировщика и фильтров мониторинга, а также настройка отчетности по результатам мониторинга. Благодаря тому, что проверки мониторинга запланированы от каждой минуты до каждых 3 часов, ваша команда получит высокий уровень гибкости в настройке мониторинга.

Прежде чем начать

Insomnia Request Коллекции и проектная документация


Прежде чем приступить к настройке устройства, обратите внимание, что Dotcom-Monitor поддерживает импорт как коллекций запросов Insomnia, так и проектных документов. Однако существуют различия в том, как мы обрабатываем импортированную проектную документацию и коллекции запросов
.


Чтобы
загрузить коллекцию или документ Insomnia в Dotcom-Monitor, обязательно экспортируйте данные Insomnia в JSON-файл.

Когда вы загружаете проектный документ Insomnia в Dotcom-Monitor и запускаете тест мониторинга, мы выполняем только первый набор из списка наборов тестов. Все остальные наборы тестов в документе игнорируются.

Когда вы загружаете коллекцию запросов Insomnia в Dotcom-Monitor, мы выполняем коллекцию и проверяем ответ на любые ошибки сети и кода ответа, такие как 404, 401, 500 и т. д.

Настройка устройства мониторинга сбора данных о бессоннице

Для получения краткого обзора того, как создать устройство мониторинга, пожалуйста, прочитайте статью Создание базы знаний устройства мониторинга.

Если вы собираетесь настроить мониторинг для группы коллекций Insomnia, мы рекомендуем установить одну коллекцию для каждого устройства. Для получения подробной информации см. статью Ограничения многоцелевого назначения на нашей вики.

Запрос HTTP в коллекции представляет собой отдельную задачу мониторинга и будет взиматься в соответствии с вашим пакетом. Смотрите также

приблизительный Матрица ценообразования для мониторинга WebView Статья «База знаний». Pаренда контакт твой Дотком-монитор Aсчет Executive с любой Вопросы.

Если вы хотите, чтобы Dotcom-Monitor генерировал оповещения и отправлял оповещения, когда
какое-либо условие, заданное тестами, не выполняется или при обнаружении каких-либо сетевых ошибок во время выполнения коллекции
, обязательно настройте параметры оповещения устройства.

Импорт коллекции и дизайн-документа Insomnia

Щелчок импорт и выберите JSON-файл с коллекцией или документом Insomnia для отправки. Teh Сценарий «Бессонница» будет отображаться в папке Запросы на взыскание задолженности секция.

Тайм-аут коллекции

Время ожидания сбора, измеряемое в секундах, определяет время, в течение которого устройство должно ожидать завершения запросов и тестов Insomnia, прежде чем завершить задачу и выдать ошибку.

Подготовка сценария

Ознакомьтесь со статьей Использование скрипта подготовки .

Защита данных в запросах

О том, как защитить конфиденциальную информацию, отправляемую вместе с запросами Insomnia, читайте в статье Защита конфиденциальных данных в запросах Insomnia с помощью Dotcom-Monitor .

Игнорировать сетевые ошибки

Сетевые ошибки могут включать ошибки разрешения DNS, тайм-ауты/ошибки TCP-соединения или случаи, когда сервер прерывает или сбрасывает соединение с кодом состояния ответа 4xx или 5xx (и без данных). По умолчанию Dotcom-Monitor генерирует ошибки и отправляет оповещения об ошибках сети Insomnia, возникших во время выполнения. Если сетевые ошибки вас не беспокоят или это ожидаемое поведение системы, вы можете настроить устройство мониторинга Insomnia Collection для фильтрации этого типа ошибок.

Если для параметра Игнорировать сетевые ошибки установлено значение Да, Dotcom-Monitor не будет выдавать ошибку при неудачных запросах из коллекции Insomnia и изменит состояние устройства на Предупреждение. Однако вы увидите ошибки HTTP в отчетах о сеансах мониторинга. В этом сценарии для проверки допустимости ответа будет использоваться набор тестов коллекции.

Как правило, рекомендуется включить опцию Игнорировать сетевые ошибки , если вы хотите получать результаты мониторинга, полностью основанные на тестах, импортированных с вашей коллекцией Insomnia.

Допустим, у нас есть документ Insomnia, проверяющий код ошибки 401 в ответ на неправильный ввод информации для входа.

Если опция Игнорировать сетевые ошибки установлена в Дотком-Монитор и в ответе получен код состояния ответа 401 Неавторизованный , система проигнорирует ошибку и интерпретирует проверку мониторинга как успешно пройденную.

Если для параметра Игнорировать сетевые ошибки установлено значение Нет для того же устройства мониторинга Insomnia Collection, система выдаст ошибку обо всех сетевых ошибках, полученных при выполнении сбора, включая ответ 401 Unauthorized . Состояние устройства будет установлено на Оповещение.

Игнорировать коды ошибок

Пожалуйста, ознакомьтесь с разделом Игнорирование ошибок веб-запросов для мониторинга веб-служб и инфраструктуры Интернета

Мониторинг API на основе OAuth 2.0

Как правило, вызов API службы с использованием OAuth 2.0 включает в себя два последовательных шага: во-первых, получение маркера доступа API с помощью механизма проверки подлинности маркера носителя. Во-вторых, использование выданного токена носителя для запроса пользовательских данных от службы.

Однако из-за нерешенной проблемы Insomnia с получением маркеров доступа OAuth в новых средах эта проверка подлинности на основе маркеров завершается сбоем при импорте в Dotcom-Monitor. Другими словами, второй запрос теряет свою ссылку на токен носителя, полученный при первом запросе.

В качестве обходного пути вызов API, требующий маркера носителя, может быть обработан в одном запросе в Insomnia.

Чтобы импортировать и отслеживать коллекцию Insomnia с помощью Dotcom-Monitor, избегайте запроса маркера проверки подлинности при первом вызове API коллекции. Вместо этого настройте проверку подлинности непосредственно в запросе данных, используя тип проверки подлинности OAuth 2.

 

Таким образом, коллекция Insomnia будет импортирована и корректно выполнена в Dotcom-Monitor.