Temporal-воркеры

Раздел предназначен для контроля Temporal-воркеров, которые выполняют сценарии миссий WCS. По данным в этом окне администратор может проверить:

запущены ли ожидаемые экземпляры воркеров;
какие очереди задач они обслуживают;
какая версия приложения развернута;
на каких хостах работают воркеры;
какая версия деплоймента назначена текущей.

Раздел используется для диагностики. Запускать, останавливать и перенастраивать воркеры из интерфейса WCS нельзя.

Путь: «Настройки» → «Temporal-воркеры».

Как Temporal-воркеры используются в WCS

Temporal управляет последовательностью выполнения сценария, но не исполняет прикладной код самостоятельно. Для этого служат воркеры — отдельные процессы, которые получают задания из очередей Temporal и выполняют зарегистрированные в них workflow и activity.

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

В разделе используются следующие понятия:

Инстанс воркера — отдельно запущенный экземпляр процесса-воркера. Несколько инстансов одного приложения могут одновременно обслуживать одну очередь: это позволяет распределять нагрузку и сохранять доступность при остановке одного из экземпляров.
Очередь задач — именованный канал, из которого воркер получает предназначенные для него задания. По названию очереди можно определить, какую группу задач обслуживает инстанс.
Деплоймент воркера — логическая группа версий одного приложения или сервиса-воркера. Деплоймент объединяет сборки с общим назначением и позволяет Temporal различать их при обновлении.
ID сборки — идентификатор конкретной версии кода внутри деплоймента. Сочетание имени деплоймента и ID сборки определяет версию воркера.
Текущая версия — версия деплоймента, которую Temporal считает основной в конфигурации маршрутизации. Это не означает, что все инстансы обязаны сразу работать на ней: при поэтапном обновлении или закреплении версий часть workflow может продолжать выполняться на другой сборке.

Что проверять в этом разделе

При штатной работе на вкладке «Инстансы» должны присутствовать ожидаемые воркеры со статусом running, нужными очередями задач и актуальными ID сборок. Несколько строк для одного деплоймента или одной очереди обычно означают, что запущено несколько экземпляров приложения.

Вкладка «Деплойменты» позволяет сопоставить каждый деплоймент с его текущей версией. Если в строках инстансов одновременно видны разные ID сборок, это может означать поэтапное обновление или обслуживание workflow, закрепленных за предыдущей версией. Соответствие ожидаемой схеме развертывания следует проверять по конфигурации конкретного контура.

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

Общая информация и обновление данных

Под заголовком отображается «Пространство имён: …». Пространство имён изолирует набор workflow, очередей и воркеров в Temporal. При диагностике убедитесь, что открыты данные нужного контура.

Справа показаны дата и время последней успешной загрузки текущего списка. Кнопка «Обновить» повторно запрашивает данные активной вкладки. Используйте её после запуска, остановки или обновления сервисов, чтобы проверить новое состояние. Во время загрузки кнопка недоступна.

Вкладка «Инстансы»

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

Над таблицей расположены:

поле «Поиск по инстансу, деплойменту, очереди…» — фильтрует уже загруженный список. Введите часть идентификатора инстанса, имени деплоймента или очереди задач. Чтобы снова показать все строки, очистите поле;
флажок «Включая системные воркеры» — добавляет в список воркеры, помеченные системой как служебные. По умолчанию они скрыты, чтобы не перегружать список. При изменении флажка данные загружаются заново.

Поля таблицы:

«Статус» — состояние инстанса по данным Temporal. running означает, что инстанс работает; такой статус выделяется цветом. Другие значения выводятся без преобразования и требуют проверки состояния соответствующего сервиса. Если значение не получено, отображается «—».
«Инстанс» — уникальный ключ конкретного запущенного экземпляра воркера. Он помогает отличить несколько копий одного сервиса и сопоставить строку с процессом при диагностике. Длинный ключ сокращается; наведите указатель на значение, чтобы увидеть его полностью.
«Деплоймент» — имя логической группы версий, к которой относится инстанс. Используйте его для сопоставления со строкой на вкладке «Деплойменты». «—» означает, что инстанс не сообщил имя деплоймента.
«ID сборки» — версия кода, которую выполняет инстанс. По этому полю проверяют, завершилось ли обновление и не остались ли экземпляры на неожиданной версии. «—» означает, что ID сборки не получен.
«Очередь задач» — очередь Temporal, которую опрашивает воркер. Если для ожидаемой очереди нет инстанса со статусом running, задания этой очереди могут ожидать обработки.
«Хост» — имя узла, контейнера или виртуальной машины, где запущен воркер. Поле помогает определить место запуска процесса и найти его журналы.
«SDK» — название и версия Temporal SDK, с которым запущен воркер. Значение используют при проверке совместимости и диагностике поведения клиента Temporal.
«Запущен» — дата и время запуска инстанса. По значению можно увидеть недавний перезапуск и отличить давно работающий экземпляр от нового.

Сообщение «Воркеры не найдены» означает, что по текущим условиям нет строк. Очистите поиск, при необходимости включите системные воркеры и нажмите «Обновить». Если ожидаемый инстанс не появился, проверьте его сервис вне WCS.

Общие приёмы сортировки и настройки столбцов приведены в статье «Работа с таблицами».

Вкладка «Деплойменты»

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

Поля таблицы:

«Деплоймент» — имя приложения или сервиса-воркера, объединяющее его версии. По этому значению деплоймент сопоставляется с одноименным полем на вкладке «Инстансы».
«Текущая версия» — ID сборки, которую Temporal считает текущей для данного деплоймента. Сравните значение с ID сборок работающих инстансов. Пустое значение «—» означает, что текущая версия не определена или не получена.
«Создан» — дата и время регистрации деплоймента в Temporal. Это дата создания самого деплоймента, а не время запуска инстанса и не обязательно дата выпуска текущей сборки.

Поиск и флажок системных воркеров на этой вкладке недоступны. Сообщение «Воркеры не найдены» означает, что Temporal не вернул ни одного деплоймента.

Права доступа

Раздел доступен только учётной записи с флажком «Администратор». Разрешения роли и прямые права не предоставляют доступ к этому разделу. Настройка флажка описана в статьях «Пользователи» и «Модель прав доступа».