История задач
Раздел История заданий показывает историю фоновых задач INFRAX: завершенные задачи, выполняющиеся задачи и их журналы. Из этого списка открывается окно Информация о задании, а тот же набор данных используется в компактной панели Фоновые задачи.
Обзор
История задач — это основная страница для просмотра фоновых операций в системе. Здесь видны задания, запущенные пользователем, и задания планировщика. Если собственного названия нет, таблица показывает локализованное название типа задания; если перевод недоступен — его техническое имя.
Что показывает раздел
- История заданий — полный список задач с фильтрами по типу, статусу, дате и инициатору.
- Информация о задании — карточка с метаданными, таймлайном и результатами выполнения.
- Фоновые задачи — компактная версия той же таблицы в правой боковой панели.
- Перезагрузки — второй вид той же боковой панели Фоновые задания и перезагрузки; вид выбирается сегментным переключателем.
Пока задача выполняется, список и карточка могут обновляться автоматически. Это позволяет отслеживать длительные операции без ручной перезагрузки страницы.
Когда фоновая задача завершается, ее инициатор получает встроенное уведомление (колокольчик в шапке). Ссылка Открыть в таком уведомлении ведет в Историю заданий или в связанный раздел — например, к карточке узла для операций с агентами или на страницу Резервное копирование для задач бэкапа и восстановления. Поэтому панель задач больше не открывается автоматически после запуска операции.
Доступ
Открыть раздел можно через главное меню:
- Откройте Администрирование.
- Перейдите в Автоматизации.
- Выберите пункт История заданий.
Для просмотра страницы требуется право на раздел автоматизации задач. Если пункт меню скрыт, обратитесь к администратору.
Интерфейс
В полной версии страницы таблица показывает четыре колонки:
| Колонка | Что отображается |
|---|---|
| Статус | Текущий статус задачи с цветным индикатором. |
| Название | Собственное название задания или локализованное название его типа; если перевод недоступен — техническое имя типа. |
| Создан | Дата и время попадания задания в очередь. |
| Инициатор | Пользователь, который запустил задачу, или Планировщик для системных задач. |
Компактный режим
В панели «Фоновые задания и перезагрузки», на виде «Задания», тот же список отображается в компактном режиме. В нем остаются только колонки Статус и Название, а служебные поля скрываются.
Полная страница обновляет таблицу каждые 3 секунды. Компактная панель Фоновые задачи обновляет список раз в секунду, пока она открыта.
Фильтрация
Фильтры помогают быстро сузить список задач до нужных записей.
Переключатель типа задач
Вверху страницы расположен переключатель Пользовательские / Системные / Все. В текущей версии Пользовательские скрывает системные записи, а варианты Системные и Все могут показывать и задания планировщика, и пользовательские задания. Учитывайте это при проверке списка.
Фильтры таблицы
| Колонка | Тип фильтра |
|---|---|
| Статус | Выпадающий список: Любой, Выполнено, Выполняется, Ошибка, Прервано. |
| Создан | Выбор диапазона дат. |
| Название | Текстовый поиск по названию задачи. |
| Инициатор | Поиск по имени пользователя. |
Сортировка
Все колонки поддерживают сортировку по возрастанию и убыванию. Достаточно нажать на заголовок колонки.
Информация о задании
Нажмите на строку в таблице, чтобы открыть модальное окно Информация о задании. В нем отображаются метаданные задачи, таймлайн выполнения и дополнительные данные по завершению.
Что видно в карточке
| Блок | Содержимое |
|---|---|
| Основная информация | ID задания, название, узел сети, инициатор и статус. |
| Статус | Для выполняющейся задачи, которая поддерживает отмену, доступна кнопка Прервать. Пока запрос отправляется, кнопка показывает Отправка сигнала..., а затем Отменяется.... |
| Ход выполнения задания | Таймлайн с отметками времени и текстом событий. |
| Результаты выполнения скрипта | Показываются только для заданий выполнения скрипта. Здесь отдельно выводятся обычный результат программы и сообщения об ошибках; в окне они обозначены как stdout и stderr. |
Когда задача находится в статусе Выполняется, карточка обновляет данные каждую секунду. После запроса на прерывание опрос продолжается, пока задача не перейдет в финальное состояние.
Статусы
В интерфейсе используются четыре пользовательских статуса задач:
| Статус | Индикатор | Описание |
|---|---|---|
| Выполняется | Синий индикатор и значок загрузки | Задача сейчас выполняется. Если этот тип запуска поддерживает отмену, в карточке доступна кнопка Прервать. |
| Выполнено | Зеленый индикатор и значок успеха | Задача завершилась успешно. |
| Ошибка | Красный индикатор и значок ошибки | Задача завершилась с ошибкой, детали смотрите в карточке. |
| Прервано | Серый индикатор и значок запрета | Задача была остановлена пользователем или системой. |
Прерывание
INFRAX позволяет прервать выполняющуюся задачу, если этот тип запуска поддерживает отмену.
Для ручного запуска скрипта кнопка появляется после того, как все выбранные агенты вернули токены запуска. Если хотя бы на одном узле установлен старый агент, скрипт продолжает выполняться совместимым способом, но отмена для всего запуска недоступна. Запуски скриптов из планировщика не поддерживают отмену.
Как прервать задачу
- Найдите задачу со статусом Выполняется.
- Откройте ее карточку.
- Нажмите кнопку Прервать справа от статуса.
- Дождитесь, пока задача перейдет в состояние Прервано.
Прерывание не происходит мгновенно. Для ручного скрипта сервер передаёт запрос агенту, который останавливает запущенный процесс и его обычные дочерние процессы; состояние проверяется примерно раз в 5 секунд. Для других типов задач используется их штатный механизм безопасной остановки. Во время ожидания кнопка меняет состояние на Отправка сигнала..., а затем на Отменяется....
Прерывание может оставить операцию в частично выполненном состоянии. Например, при массовой установке агентов задача может успеть обработать только часть узлов.
Сценарии использования
Отслеживание длинной операции
Задача: посмотреть, как идет массовая операция.
Что делать:
- Откройте История заданий.
- Выберите статус Выполняется.
- Откройте карточку нужной задачи.
- Следите за таймлайном и автообновлением.
Разбор ошибки скрипта
Задача: понять, почему выполнение скрипта завершилось с ошибкой.
Что делать:
- Отфильтруйте задачи со статусом Ошибка.
- Откройте карточку задачи.
- Проверьте Ход выполнения задания.
- Изучите Результаты выполнения скрипта. Сначала прочитайте раздел Stderr: в нём программа обычно сообщает причину ошибки.
Аудит действий пользователя
Задача: посмотреть, какие фоновые операции запускал конкретный пользователь.
Что делать:
- Переключите список на Пользовательские.
- Отфильтруйте колонку Инициатор по имени пользователя.
- При необходимости задайте диапазон дат.
Проверка системных задач
Задача: посмотреть работу планировщика.
Что делать:
- Переключите список на Системные, но учитывайте, что в текущей версии в нём могут остаться пользовательские задания.
- Отсортируйте по Создан.
- Проверьте статусы и при необходимости откройте карточки с ошибками.
Рекомендации
Что делать в первую очередь
- Начинайте с фильтра Ошибка, если операция завершилась не так, как ожидалось.
- Используйте фильтры по названию и инициатору, когда в истории много записей.
- Открывайте карточку задачи, чтобы посмотреть таймлайн и текст ошибки.
- Для длительных операций держите открытой панель Фоновые задачи.
Чего лучше избегать
- Не игнорируйте повторяющиеся ошибки в истории.
- Не прерывайте системные задачи без необходимости.
- Не запускайте одинаковые задачи параллельно, если одна из них уже выполняется.
История задач, карточка задания и боковая панель фоновых задач показывают один и тот же процесс с разных сторон. Это помогает быстро понять, что сейчас делает система, и где искать причину проблемы.