Операционный агент: запуски, повторы и отчёты

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

Открытие запуска#

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

• сколько он работал и сколько байт получил и произвёл;
• полученный и произведённый JSON, в точности то, что получил следующий шаг;
• если удалённый адрес дал ошибку, что ответила другая сторона (HTTP-статус и начало ответа) и каждую неудачную попытку;
• ответы отчёта и загрузку книги Excel, если выполнялся шаг отчёта;
• блок Оплата запуска: что он обработал и сколько стоил.

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

Статусы шагов#

• Выполнен, Выполняется, В очереди, Ожидает (предыдущих шагов).
• Ожидает повтора: шаг завершился ошибкой и попробует снова в указанное время; следующие шаги тоже ждут. Запуск продолжается сам.
• Ошибка: шаг исчерпал свои попытки. Следующие шаги пропускаются, если только вы не нарисовали ветку ошибки.
• Пропущен: шаг находился на ветке, по которой не пошли, или ему было нечего делать, например нет записи у пропущенного звонка. Запуск, шагам которого было нечего делать, всё равно завершается.
• Частично с ошибкой у запуска: одни ветки завершились, а другие нет.

Политика повторов#

У каждого шага есть политика повторов (панель Политика повторов в инспекторе): сколько попыток, от 1 до 24, и сколько минут между ними, от 1 до 1440. Значения по умолчанию:

• шаги, вызывающие удалённый адрес (вебхук, диспетчер, скачивание записи, хранилище): 24 попытки с интервалом в один час, пока адрес не ответит 2xx;
• расшифровка, сводка и письмо: 3 попытки с интервалом десять минут; отчёт по вопросам: 2 попытки с интервалом десять минут.

Удалённый адрес считается получившим вызов, когда он отвечает 2xx; любой другой ответ или его отсутствие считается неудачной попыткой. Настройка, которую можете исправить только вы, например отсутствующий получатель или недопустимый адрес, сразу приводит к ошибке, а не к повторам в течение всего дня. Часы, которые запуск ждёт повтора, не оплачиваются.

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

Журнал#

Страница агента Журнал показывает каждый шаг последних 100 запусков одной строкой, новые первыми, с номером попытки и сообщением. Отфильтруйте по Ошибка или Ожидает повтора, чтобы сразу увидеть, что требует внимания; нажмите на строку, чтобы открыть её запуск.

Все запуски проекта#

Запуски в левом меню консоли перечисляют запуски всех операционных агентов проекта за выбранный вами период (по умолчанию за этот месяц), с фильтром по агенту. Над списком: число запусков, минуты автоматизации, использованные минуты плана, стоимость по прейскуранту и списанная сумма. Экспорт в Excel скачивает период, до 5,000 запусков в одном файле; для большего сузьте даты.

Панель мониторинга может показывать звонки, запуски или и то и другое по дням, неделям или месяцам: выберите Операционные или Все агенты в её фильтре по типу агента.

Если что-то пошло не так#

• Запуск не начался: проверьте, что агент включён и у него правильный триггер. Для триггера АТС откройте Интеграции и проверьте, что АТС показывает Подключено, а звонок есть в её недавних звонках; вкладка Все запросы от АТС показывает каждый запрос, отправленный АТС, включая отклонённые. Для вебхука используйте Прослушать, чтобы увидеть, приходит ли запрос.
• Шаг постоянно повторяется: откройте запуск и прочитайте Что ответила другая сторона. Исправьте адрес, затем нажмите Повторить сейчас.
• Значение приходит пустым: откройте запуск, нажмите на шаг, который должен был его произвести, и проверьте имя поля в его выходных данных; используйте Прослушать, чтобы увидеть реальные данные триггера.