IKuznetsov: Новая страница: « = Мониторинг выполнений Workflow = Создание Workflow идёт рука об руку с их запуском. Например: * Вы добавляете новую задачу или меняете задачу, и теперь хотите попробовать изменения и запустить Workflow. * Вы хотите изучить выполнения, которые произошли или всё ещё...»

2026-10-14T15:37:18Z

Новая страница: « = Мониторинг выполнений Workflow = Создание Workflow идёт рука об руку с их запуском. Например: * Вы добавляете новую задачу или меняете задачу, и теперь хотите попробовать изменения и запустить Workflow. * Вы хотите изучить выполнения, которые произошли или всё ещё...»

Новая страница

= Мониторинг выполнений Workflow =
Создание Workflow идёт рука об руку с их запуском. Например:

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

Запуск Workflow создаёт '''выполнение'''. Выполнение содержит все детали состояния каждой задачи запущенного Workflow. Каждая задача выполняет действие с заданными входными данными и может создать результат. Давайте подробнее рассмотрим концепции, связанные с запуском Workflow.

== Выполнение Workflow ==
'''Выполнение Workflow''' — это экземпляр Workflow. В любой момент времени может выполняться столько экземпляров Workflow, сколько запрошено (в пределах ёмкости системы). Выполнение Workflow запускается вручную через '''Workflows''', автоматически через вызов '''API''', событие триггера или по расписанию. Запущенный Workflow обрабатывает свои задачи в соответствии со структурой Workflow, что приводит к выполнениям задач. Журналы выполнения для простых Workflow видны только ограниченное время. Страница «Выполнения» не отображает историю для этих Workflow. Подробности о простых Workflow см. в разделе '''Создание простого Workflow'''.

=== Состояния выполнения Workflow ===
Возможные состояния выполнения Workflow:
{| class="wikitable"
!Состояние
!Описание
|-
|'''Выполняется'''
|По крайней мере одно выполнение задачи бездействует или выполняется.
|-
|'''Успех'''
|Все задачи с соответствующими условиями завершены, и не было необработанной неудачной задачи (у неудачной задачи есть задача-преемник).
|-
|'''Ошибка'''
|Выполнение Workflow имело как минимум одну необработанную неудачную задачу. Выполняющиеся задачи завершены, и новые выполнения задач не запускаются.
|-
|'''Отменено'''
|Пользователь отменил Workflow или задачу. Попытки отмены выполняющихся задач и выполняющихся действий будут завершены.
|}

==== Доступ к выполнениям ====
Чтобы получить доступ к выполнениям Workflow:

* Перейдите к Workflow.
* Выберите '''Выполнения'''. Раскрывающееся меню содержит список времён выполнений. Список содержит соответствующие выполнения текущего вида редактирования, только «Черновик» или «Live».

== Выполнение задачи ==
'''Выполнение задачи''' — это экземпляр задачи внутри Workflow. Оно запускает действие с заданными входными данными и может вернуть результат.

* По умолчанию задача выполняется, если её предшественники завершились успешно.
* Задача выполняется до завершения действия (успех, ошибка), истечения тайм-аута или ручной отмены. У выполняющейся задачи всегда есть как минимум одно выполнение действия. В случае повторных попыток задачи или конфигураций цикла может произойти несколько выполнений действий. Результат выполнений задач определяет окончательное состояние выполнения Workflow.

=== Состояния выполнения задачи ===
Возможные состояния выполнения задачи:
{| class="wikitable"
!Состояние
!Описание
|-
|'''Бездействует'''
|Задача ещё не была запущена, так как задачи-предшественники не завершились.
|-
|'''Выполняется'''
|По крайней мере одно выполнение действия выполняется или ожидает запуска.
|-
|'''Успех'''
|Выполнение действия завершилось успешно (в случае повторной попытки последнее выполнение действия было успешным, или для цикла все выполнения действий были успешными).
|-
|'''Ошибка'''
|Выполнение действия завершилось с ошибкой (в случае повторной попытки все выполнения действий не удались, или для цикла как минимум одно или последнее выполнение действия не удалось) или истёк тайм-аут задачи.
|-
|'''Пропущено'''
|Задачи-предшественники завершены, состояние и пользовательские условия не выполнены, и пользователь настроил Workflow на пропуск этой задачи в этом случае или отключил задачу.
|-
|'''Отброшено'''
|Задачи-предшественники завершены, состояние и пользовательские условия не выполнены, и пользователь настроил Workflow на остановку этой задачи.
|-
|'''Отменено'''
|Пользователь отменил Workflow или задачу. Выполняющиеся выполнения действий были завершены.
|-
|'''Ожидание одобрения'''
|Задача приостановлена в ожидании ручного одобрения или отклонения пользователем. Workflow не продолжается до предоставления требуемого одобрения или истечения тайм-аута задачи.
|}

== Выполнение действия ==
'''Выполнение действия''' — это экземпляр действия. Вызов происходит с входными данными, определёнными в задаче. В зависимости от входных данных и реализации действия оно либо завершается успешно, либо с ошибкой и может создать результат. Для обработки действий применяются '''ограничения''' функций в AppEngine. Результаты выполнения действий никогда не могут быть больше 6 МБ минус размер журнала этого выполнения. AutomationEngine разработан как оркестратор процессов и не подходит в качестве конвейера данных. Результаты, превышающие лимит, приведут к сбою задачи. Если вам нужно работать с большими данными, можно использовать пользовательскую задачу JavaScript, чтобы извлечь и сохранить данные непосредственно в конечном месте. Результат выполнений действий определяет поведение и окончательное состояние выполнения задачи.

=== Состояния выполнения действия ===
Возможные состояния выполнения действия:
{| class="wikitable"
!Состояние
!Описание
|-
|'''Выполняется'''
|Выполнение действия выполняется.
|-
|'''Успех'''
|Выполнение действия завершилось успешно.
|-
|'''Ошибка'''
|Выполнение действия завершилось с ошибкой.
|}

=== Цикл задачи, повтор при ошибке и тайм-аут задачи ===

==== Цикл ====
Опция '''Цикл задачи''' позволяет задаче выполнять итерацию по списку элементов. Хотя выполнение задачи одно, выполнение действия происходит для каждой итерации. Последствия для задачи:

* Результат задачи — это список, содержащий результаты выполнений действий.
* Журнал задачи — это конкатенация журналов выполнений действий.
* Состояние задачи — '''Успех''', если все выполнения действий успешны, или '''Ошибка''', если хотя бы одно не удалось.

==== Повтор при ошибке ====
Опция '''Повтор при ошибке''' повторяет задачу на основе заданного количества попыток и ждёт между повторными попытками указанную задержку. Хотя выполнение задачи одно, выполнение действия происходит для каждой попытки. Последствия для задачи: состояние задачи — '''Успех''' при первом успешном выполнении действия и '''Ошибка''', если ни одно не удалось.

==== Комбинированный цикл и повтор при ошибке ====
Существует возможность комбинировать цикл задачи и повтор при ошибке.

* Повторные попытки происходят только для неудачных итераций.
* Дополнительные выполнения действий происходят для каждой неудачной итерации на основе конфигурации повторных попыток.
* Можно перезапустить все итерации, если одно из задействованных выполнений действий завершается ошибкой.

==== Тайм-аут ====
Тайм-аут задачи применяется всегда.

* Для цикла задачи или повторной попытки задача завершится с ошибкой, как только истечёт тайм-аут задачи.
* Любое выполняющееся на данный момент выполнение действия будет завершено, но его успех или неудача больше не учитываются для результирующего состояния задачи.

=== Период хранения выполнений ===
Информация о выполнении хранится в течение 30 дней с даты начала выполнения. Это относится к информации о выполнении Workflow, задачи и действия. Это также подразумевает тайм-аут выполнения Workflow в 30 дней. После этого периода дальнейшая обработка не происходит, так как состояние выполнения удаляется.

== Запуск Workflow ==
Workflow можно запустить вручную через '''Workflows''', через запрос '''API''' или через событие триггера либо расписание. Существуют черновики и live Workflow; оба можно запустить вручную, при этом автоматические триггеры применяются только к live Workflow.

Чтобы запустить Workflow вручную:

* Откройте список доступных Workflow. Это представление по умолчанию при запуске приложения '''Workflows'''.
* Выполните одно из следующих действий:
** В таблице найдите Workflow, откройте меню и выберите '''Запустить Workflow'''.
** В таблице выберите имя Workflow, чтобы открыть его, затем выберите '''Запустить'''.
* ''Необязательно'': если у Workflow определён событийный триггер, вам будет представлен диалог, где можно настроить контекст события по своему усмотрению. Чтобы подтвердить изменения, выберите '''Запустить'''.
* Откроется монитор выполнения и отобразит текущее состояние выполнения.

=== Настройки авторизации Workflow ===
Workflow всегда выполняется в контексте пользователя, '''актора'''. Актора Workflow можно найти в настройках Workflow (в редакторе Workflow). По умолчанию последний редактор Workflow является актором. Вы можете контролировать, какие разрешения вы авторизуете для службы Workflow, если ваш пользователь является актором. Настройка авторизации Workflow доступна через меню '''Настройки''' в правом верхнем углу приложения '''Workflows'''. Первый запуск Workflow в среде требует настройки авторизации для службы Workflow. В модальном окне необходимо авторизовать службу Workflow. Выбрав вариант по умолчанию ('''Разрешить и запустить'''), вы предоставляете разрешения вашего пользователя службе Workflow. Вы можете вернуться к настройке авторизации, чтобы сделать более строгую конфигурацию в любое время. Служба Workflow никогда не может превысить разрешения вашего фактического пользователя, независимо от настроек авторизации.

=== Запуск Workflow с входными данными ===
При запуске Workflow через '''API службы Automation''' вы можете предоставить входные данные для Workflow. Это рекомендуемый подход для передачи информации в выполнение Workflow. Найдите подробности о запросе в документации Swagger для конечной точки <code>/workflows/{id}/run</code> '''API службы Automation'''. Эта конечная точка ожидает следующие атрибуты в полезной нагрузке JSON:

* <code>input</code>: пользовательский объект JSON со свойствами для доступа к Workflow.
* <code>params</code>: системный объект JSON со свойствами для доступа к Workflow, например переданными от автоматических событийных триггеров.

Он отделён от <code>input</code>, чтобы избежать конфликтов с пользовательскими входными данными, предоставленными через '''API'''. Оба доступны в Workflow через выражение <code>execution()</code>, например <code>execution()['input']['foo']</code>.

=== Результаты Workflow ===
Результат Workflow вычисляется на последнем шаге перед завершением. Вычисленный результат Workflow, не являющийся допустимым документом JSON или превышающий лимит в 10 МБ, приводит к сбою выполнения Workflow. Результаты Workflow недоступны для простых Workflow.

== Монитор выполнения ==
Если вы запускаете Workflow или переходите к существующему выполнению, вам представляется монитор выполнения. В мониторе выполнения можно увидеть, была ли задача успешной или она завершилась с ошибкой. Чтобы узнать, является ли выполнение черновиком или live Workflow, перейдите в '''Детали > Версия Workflow'''. Ниже приведён пример выполненного Workflow в черновике.

Монитор выполнения состоит из следующих разделов.

=== Раздел заголовка ===
Раздел заголовка показывает заголовок Workflow, выполняющегося в данный момент или выполнявшегося ранее.

* Справа от заголовка '''Выполняется''', '''Успех''' или '''Ошибка''' указывает статус выполнения Workflow.
* Доступные элементы управления включают опции для редактирования Workflow, отмены выполняющегося выполнения, обновления данных, повторного запуска последнего выполнения или открытия истории выполнений Workflow.

'''Показать мне: Монитор выполнения: Заголовок'''

=== Панель графа выполнения ===
Под разделом заголовка панель графа выполнения показывает Workflow, его задачи и их состояние во время выполнения.

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

'''Показать мне: Монитор выполнения: Граф'''

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

'''Показать мне: Монитор выполнения: Журнал'''

=== Панель сведений ===
Панель сведений справа предоставляет доступ к детальным атрибутам выполнения в зависимости от вашего выбора на панели монитора выполнения.

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

'''Показать мне: Монитор выполнения: Детали'''

==== Детали ====
Вкладка '''Детали''' состоит из:

* '''Состояние''': состояние действия.
* '''Информация о состоянии''': дополнительная информация о текущем состоянии, если она доступна. Для успешных задач это поле обычно пусто. Для неудачных задач здесь будет отображаться дополнительная информация об ошибке, например, задача была пропущена из-за условия задачи. Это сообщение об ошибке отображается в панели журнала.
* '''Начато в''': время, когда задача начала выполняться.
* '''Завершено в''': время завершения задачи.
* '''Время выполнения''': продолжительность в секундах, необходимая для завершения.
* '''Условия''': настроенное условие. Если вы выбираете конкретную задачу, также отображается тип действия задачи. Задачи с предшественниками (не задачи, напрямую связанные с триггером) также показывают условия и результаты их оценки, чтобы вы могли детально проанализировать, почему задача выполнилась или нет.

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

==== Параметры ====
Вкладка '''Параметры''' доступна только для Workflow при выборе триггера. Она предоставляет доступ к параметрам, переданным выполнению, например контексту события, если выполнение было запущено событием.

==== Результат ====
Вкладка '''Результат''' показывает результат задачи для выбранной задачи или результат выполнения Workflow слева.

== Мониторинг выполнения ==
Если вы открываете выполнение, запустив Workflow, или открываете монитор существующего выполнения, отображается монитор выполнения. Монитор выполнения будет обновляться до тех пор, пока выполнение не достигнет окончательного состояния ('''Успех''', '''Ошибка'''). Вы можете обнаружить больше деталей в мониторе, выбирая отдельные задачи и просматривая их вывод в панели журнала и их атрибуты в панели сведений. Чтобы активно изменить состояние выполнения или отдельной задачи, см. разделы ниже.

== Мониторинг выполнений sub-workflow ==
Когда Workflow использует '''действие «Запустить Workflow»''', каждый вызов создаёт собственное выполнение Workflow. Выполнения родительского Workflow и sub-workflow связаны в обоих направлениях в мониторе выполнения.

=== Из родительского выполнения ===
Выберите задачу '''Запустить Workflow''' в мониторе выполнения. Панель '''Детали''' показывает имя выбранного sub-workflow вместе с деталями задачи.

* Если sub-workflow имеет одно выполнение, выберите '''Просмотреть выполнение''', чтобы открыть его монитор выполнения напрямую.
* Если задача зациклена и создала несколько выполнений sub-workflow, выберите '''Просмотреть выполнения''', чтобы открыть список выполнений, отфильтрованный по этим выполнениям.

=== Из выполнения sub-workflow ===
В выполнении sub-workflow раздел триггера показывает тип триггера '''Workflow''' и имя вызывающего Workflow. Выберите '''Просмотреть выполнение''', чтобы вернуться к монитору родительского выполнения.

=== Фильтрация списка выполнений для выполнений sub-workflow ===
Чтобы увидеть все выполнения, запущенные другим Workflow, откройте вкладку '''Выполнения''' и отфильтруйте по типу триггера '''Workflow'''. Используйте это для аудита или отладки вызовов sub-workflow во всех ваших Workflow. Подробности об отмене выполнений sub-workflow см. в разделе '''Отмена выполнения''' — отмена родительского Workflow рекурсивно отменяет все выполняющиеся выполнения sub-workflow и их задачи.

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

* Выполняющаяся задача будет обработана, но завершится в состоянии '''Отменено'''.
* Дальнейшая обработка Workflow и последующих задач зависит от их конфигураций условий (например, «запустить при успехе» или «запустить при ошибке или отмене»).
* Откройте выполнения из верхней навигации.
* Выберите выполнение из списка, чтобы открыть монитор выполнения.
* На панели монитора выполнения выберите задачу, которую хотите отменить.
* Выберите '''Отменить задачу''' в панели сведений. Задача продолжит обработку (для зацикленных задач — только текущую итерацию), но завершится в состоянии '''Отменено'''. Дальнейшая обработка Workflow зависит от конфигураций условий задач.

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

* Откройте выполнения из верхней навигации.
* Выберите '''> Отменить выполнение''' в списке выполнений или в правом верхнем углу монитора выполнения. Все выполняющиеся задачи будут завершены, но новые задачи не начнутся, и выполнение завершится в состоянии '''Отменено'''.

== Повтор выполнения ==
Во время разработки или для восстановления после сбоя/незавершённого состояния в сторонних системах вы можете захотеть повторить существующее выполнение. Может быть событийный триггер, который трудно воспроизвести, и было бы удобно, если бы вы могли повторить выполнение после внесения некоторых изменений в Workflow. Повторный запуск означает, что вы хотите использовать конфигурацию <code>input</code> и <code>params</code> исходного выполнения.

* Откройте выполнения из верхней навигации.
* Выберите '''> Повторить выполнение''' в списке выполнений или в мониторе выполнения.
* Если Workflow определяет событийный триггер, вам будет представлен контекст события, как он был для исходного выполнения. Настройте значения по своему усмотрению и подтвердите с помощью '''Запустить'''.

'''Повторное выполнение и параметры''' Если вы использовали выражения вроде <code><nowiki>{{ event() }}</nowiki></code> и повторяете выполнение, запущенное событийным триггером, выражения будут иметь доступ к контексту события из исходного выполнения.

Мониторинг выполнений Workflow - История изменений