Выполнение мониторов по запросу

Материал из Документация Ключ-АСТРОМ

Выполнение мониторов по запросу

Для запуска выполнения через веб-интерфейс:

  1. В правом верхнем углу страницы с подробными сведениями о мониторе выберите Выполнение по запросу.
  2. В списке Местоположения выберите местоположения, для которых вы хотите запускать выполнение по запросу.
    • Обратите внимание, что для выполнения этой операции вы можете выбрать комбинацию назначенных и неназначенных общедоступных местоположений.
  3. Выберите режим обработки — это будет применено ко всем выбранным местам при данном выполнении.
    • Стандартный (по умолчанию) режим — выполнение этих операций способствует обнаружению проблем, а также сбору статистики доступности и производительности. Результаты выполнения можно просмотреть в разделе Анализ выполнений.
    • Отключите обнаружение проблем — результаты выполнения учитываются в статистике доступности и производительности, но не в обнаружении проблем. Вы можете просмотреть результаты выполнения при анализе выполнений.
    • Представлены только подробные сведения о выполнении — данные о выполнении не используются для составления статистики доступности и производительности, а также для выявления проблем. Вы по-прежнему сможете получить доступ к результатам при анализе выполнений.
    • Обратите внимание, что для всех режимов обработки результаты выполнения отображаются в списке выполнения по запросу в веб-интерфейсе и могут быть получены через API выполнения по запросу.
  4. При необходимости настройте:
    • Сбой при нарушении порогового значения производительности — по умолчанию выполнение по запросу завершается с ошибкой при нарушении порогового значения производительности, поскольку его основная цель — проверка новых версий программного обеспечения в вашем конвейере CI/CD. Однако вы можете отключить эту настройку, чтобы выполнение по запросу вело себя как обычное запланированное выполнение (нарушение порогового значения производительности не приводит к сбою этого выполнения, но способствует возникновению проблемы с производительностью).
    • Создание скриншота (только для мониторов браузера) — при успешном выполнении система делает скриншот. Чтобы просмотреть скриншот, перейдите в раздел Анализ выполнений.
    • Обработка проблем с SSL (только для HTTP-мониторов) — монитор выдаёт ошибку, если один или несколько его запросов обнаруживают просроченный, отсутствующий или истекающий SSL-сертификат.
  5. Выберите Запустить сейчас — появится диалоговое окно со сводкой, в котором будут перечислены места выполнения; в списке выполнения отобразятся новые записи для запущенных запусков. Начальный этап выполнения — Triggered.

Любые изменения, внесённые вами в скрипт мониторинга (конфигурацию), немедленно становятся доступны для выполнения по запросу в общедоступных или частных локациях.

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

Регулирование и ограничения

Для каждого пользователя предусмотрен обязательный 60-секундный перерыв между последовательными запусками монитора по запросу из одного и того же места (независимо от того, запускается ли он через веб-интерфейс или API).

Примеры регулирования скорости

Все эти примеры предполагают выполнение из одного и того же места.

  • Пользователь A запускает монитор через API в течение 60 секунд после запуска того же монитора через пользовательский интерфейс — с ограничением частоты.
  • Пользователь B запускает монитор через API в течение 60 секунд после того, как пользователь A запустит тот же монитор через пользовательский интерфейс — без ограничения скорости.
  • Пользователь B активирует монитор через пользовательский интерфейс в течение 60 секунд после того, как пользователь A активирует тот же монитор через пользовательский интерфейс — ограничение скорости не происходит.
  • Пользователь B запускает мониторинг через API в течение 60 секунд после того, как пользователь A запустил тот же мониторинг через API — без ограничения скорости.

При запуске нескольких операций по запросу через API существует ограничение в 100 операций в одной партии.

В среде Ключ-АСТРОМ существует ограничение в 5000 выполнений по запросу в минуту.

В каждом пакете можно определить до 64 пар ключ-значение метаданных, при этом длина каждого ключа и значения может составлять до 1024 символов.

Сбои при запуске

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

Дополнительные причины, по которым выполнение запросов по требованию может не запускаться успешно через API: удаление монитора, некорректное указание идентификаторов монитора или местоположения, некорректное указание идентификаторов связанных служб или приложений, удаление местоположения, проблемы с общедоступной синтетической инфраструктурой или проблемы с вашей средой мониторинга Ключ-АСТРОМ.

Если запуск выполнения через веб-интерфейс не удаётся, причины отображаются в сводке статуса запуска после выбора пункта Запустить сейчас. Этап выполнения в списке запусков — Not triggered. Подробная информация о запусках, не запущенных через API, возвращается в параметрах ответа POST-запроса (triggeringProblemsCount, triggeringProblemsDetails).

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

Список выполнений

В списке выполнений отображаются все выполнения по запросу (инициированные любым пользователем через веб-интерфейс или API) для данного монитора в течение выбранного временного интервала.

Для просмотра списка выполнений вам потребуется лицензия DPS.

Идентификатор выполнения — это уникальный идентификатор, присваиваемый каждому выполнению; если вы запускаете выполнения из всех мест, то для выполнения в каждом месте будет присвоен свой уникальный идентификатор.

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

Исходный код показывает, было ли выполнение запущено через веб-интерфейс UI или через API.

User — это идентификатор пользователя Ключ-АСТРОМ, который инициировал выполнение операции.

Местоположение — это название общественного или частного места, откуда осуществлялся контроль.

Этап выполнения определяет различные этапы выполнения по запросу. Начальное значение равно Triggered или Not triggered. После завершения выполнения значение изменяется на Executed. На этом этапе доступны основные результаты, такие как продолжительность и код состояния. Индикатор выполнения продолжает отображаться на этом этапе Executed до тех пор, пока не станут доступны подробные результаты и значение не изменится на Data retrieved. Если для одного местоположения запускается несколько последовательных выполнений, первое выполнение помечается как Triggered; остальные выполнения помечаются как Waiting.

Результат указывает, было ли выполнение операции Success или Failure (с указанием причины сбоя).

Для просмотра подробностей выполнения выберите значок развёртывания в первом столбце.