Агенты

Агенты (Discovery Agent) это программные компоненты системы ИТМен, которые выполняют сбор данных в рамках задач инвентаризации.

Возможности агента зависят от его типа:

• Лайт (DiscoveryAgentLightNative) - может только собирать данные на устройстве, на котором установлен, и передавать данные интеракту или другому агенту (Агенту-шлюзу).
• Полный (DiscoveryAgentNative) - это агент, который помимо возможностей лайт агента может получать данные от других агентов, т.е. выполняет роль агента-шлюза. 

В разделе Сбор данных / Агенты автоматически отображаются все установленные агенты. Вы можете:Установка агента выполняется вручную (см. инструкции для Windows, для Linux).

• Получить данные об установленных агентах:
  • Свойства агента
  • Устройство, на котором установлен агент
  • Статус агента
  • Структуру подчиненности агентов (кому агент передает данные)
• Изменять настройки агента при редактировании:
  • Теги
  • Количество потоков
  • Родитель агента (можно переопределить, кому агент будет передавать данные - интеракту или другому агенту-шлюзу)
  • Возможность получать данные от других агентов
  • Логи
• Управлять участием агента в задачах:
  • Назначать / исключать из задач
  • Управлять состояние агента (разрешен или запрещен сбор данных)
• Управлять установкой и обновлением агентов:
  • Скачать дистрибутив для установки агента. Установка агента выполняется вручную (см. инструкции для Windows, для Linux)
  • Настраивать автоматическое обновление агентов
  • Инициировать обновление агента вручнуюВыполнять действия с агентами
• Удалять записи об агентах из системы (не влияет на установленного агента)

Для начала работы:

• Наведите курсор на раздел Сбор данных в верхнем меню.
• Выберите пункт Агенты в открывшемся подменю.

Для начала работы перейдите в раздел Сбор данных / Агенты с помощью меню.

В таблице представлена информация обо всех установленных агентах. См. описание свойств агента.

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

При работе с таблицей агентов вам доступны стандартные возможности интерфейса таблиц:

• Группировка по свойству агента
• Фильтрация
  • По отдельным свойствам агента
  • По данным об устройстве - вы можете указать значение одного из свойств устройства, которое есть в дополнительной информации. Например, установить фильтр: [Данные об устройстве] [содержит] [WORK], чтобы найти всех агентов, установленных в домене WORK или имеющих название устройства WORK. Обратите внимание, вы можете добавить несколько фильтров по данным об устройстве, с разными значениями. 
• Поиск
  Обратите внимание, поиск выполняется с учетом всех свойств из таблицы, включая разворачиваемые данные, но только по данным одного поля. Например, вы можете указать в строке поиска  определенное расположение устройства; или указать ОС устройства, но не можете сразу искать и по расположению и по ОС в одном запросе.
• Управление отображением:
  • Скрыть, показать столбцы
  • Изменить плотность строк
• Сортировка
• Выгрузка данных в формате CSV

Нажмите на иконку рядом с идентификатором агента. После этого развернется дополнительная информация:

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

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

Для просмотра карточки агента перейдите в раздел Сбор данных / Агенты с помощью меню.

Далее:

• Нажмите на идентификатор агента в таблице.

Или:

• Нажмите иконку рядом с идентификатором агента в таблице.
• Развернется дополнительная информация об агенте.
• Нажмите кнопку Перейти к агенту.

Или:

• В правой части таблицы нажмите иконку справа в строке агента. 
• Откроется подменю.
• Выберите пункт Перейти к агенту.

Откроется страница карточки агента. Cм. описание свойств агента.

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

Для этого:

• Перейдите в раздел Сбор данных / Агенты с помощью верхнего меню.
• Нажмите кнопку Скачать агента.
• Откроется список дистрибутивов.
• Выберите агента в соответствии с:
  • Необходимой функциональностю агента:
    • Native Light  - лайт версия, может только собирать и передавать данные интеракту или другому агенту (Агенту-шлюзу). Выполняет только задачи локальной инвентаризации.
    • Native - полная версия, которая помимо возможностей лайт агента может получать данные от других агентов, т.е. выполняет роль агента-шлюза. Может выполнять все типы задач инвентаризации.
  • Операционной системой, которая установлена на устройстве, где будет размещен агент.
• Нажмите кнопку Скачать агента в соответствующей строке.
• Для установки следуйте соответствующей инструкции:
  • Установка агента на Windows
  • Установка агента на Linux

Некоторые свойства агента могут быть отредактированы через интерфейс.

Редактирование доступно только при выполнении условий:

• Версия агента 6.4 или выше.
• Агент имеет статус В сети.
• Интеракт, с которым связан агент, доступен.

Для начала редактирования:

• Перейдите в раздел Сбор данных / Агенты с помощью меню.
• Найдите агента в таблице и нажмите на его идентификатор.
• Откроется карточка агента. Cм. описание свойств агента.
• Нажмите кнопку Редактировать в правом нижнем углу.
  Если кнопка не активна, то редактирование недоступно, так как не выполнились условия, описанные выше.

Особенности:

• После сохранения изменений данные могут не сразу отобразиться в таблице, так как выполняется перезапись конфигурации агента и его перезапуск. Действие может занимать до 3х минут, обновите страницу вручную, чтобы увидеть изменения.
• Если при сохранении данных какое-либо изменение не вышло применить (например, если был изменен родитель агента, но он оказался недоступен), то все измененные настройки не будут сохранены. Частичного применения изменений нет.
• Редактирование агента не инициирует запуск задач инвентаризации вне расписания. Если нужно перезапустить задачу, то это можно сделать вручную стандартным способом в разделе Сбор данных / Задачи инвентаризации.

Большее количество свойств можно отредактировать напрямую через файл конфигурации агента.

Вы можете инициировать обновление агентов через интерфейс:

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

Условие выполнения:

• Версия агента 6.5 или выше.
• Для агента доступен более новый дистрибутив.
• В свойства агента Разрешено обновление.
• У учетной записи, из-под которой работает агент, достаточно прав на выполнение действия.

Для настройки автоматического обновления:

• Перейдите в раздел Сбор данных / Агенты.
• Включите / выключите переключатель над таблицей со списком агентов.

Вручную обновление агентов можно сделать следующими способами:

• Из таблицы агентов:
  • Перейдите в раздел Сбор данных / Агенты.
  • Найдите нужного агента в таблице и нажмите иконку в строке агента в правой части таблицы.
  • Выберите действие: Обновить. Если действие не активно, значит не выполнилось хотя бы одно условий выполнения.
• Через массовые действия.
• При редактировании агента (кнопка обновления расположена в левом нижнем углу страницы).

При выполнении обновления:

• Текущая версия агента будет удалена.
• Новая версия агента будет установлена. При этом предыдущие настройки агента будут сохранены и перенесены в новую версию. В том числе идентификатор и тип агента не изменятся.
• Если при выполнении действия интеракт оказался не доступен, то агент не будет обновлен.
• Если при выполнении действия агент оказался недоступен, то обновление будет выполнено, как только агент ответит интеракту.

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

В разделе Сбор данных / Агенты вы можете:

• Назначить агента на задачи.
• Посмотреть список задач, в которых задействован агент.
• Исключить агента из задач.
• Запретить / разрешить сбор данных. При запрете агент останется назначенным на задачу, но не будет задействован.

Эти действия доступны для любого агента.

Управление задачами агента не инициирует запуск задач инвентаризации вне расписания. Если нужно перезапустить задачу, то это можно сделать вручную стандартным способом в разделе Сбор данных / Задачи инвентаризации.

Для просмотра задач, на которые назначен агент:

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

Или нажмите на идентификатор агента и перейдите на вкладку Задачи агента в его карточке.

Для назначения агента на задачи его тип должен соответствовать типу инвентаризации задачи:

• Агент с типом Лайт - может быть назначен только на задачи локальной инвентаризации.
• Агент с типом Полный - может быть назначен на задачи с любым типом инвентаризации.

Назначение на задачи можно сделать применительно к одному агенту или сразу к нескольким (через массовые действия).

Чтобы назначить одного агента на задачи:

• Перейдите в раздел Сбор данных / Агенты с помощью меню.
• Найдите агента в таблице и нажмите на его идентификатор. Откроется карточка агента.
• Перейдите на вкладку Задачи агента.
• Нажмите кнопку Выбрать задачи.
• Откроется окно списка задач.
  Обратите внимание, в списке выводятся все задачи (без проверки позволяет ли тип агента выполнять данный вид задач, подробнее).
• Отметьте задачи, на которые нужно назначить агента, с помощью чекбокса .
  Вы также можете использовать чекбокс в заголовке столбца таблицы, чтобы выбрать все задачи на странице.
  Если вы выключите чекбокс на каких-либо задачах, то агент будет отключен (добавлен в Исключенные) в данных задачах.
• Нажмите кнопку Применить, чтобы сохранить изменения.

Чтобы назначить несколько агентов сразу на одинаковый список задач:

• Перейдите в раздел Сбор данных / Агенты с помощью меню.
• Отметьте нужных агентов с помощью чекбокса .
  Вы также можете использовать чекбокс в заголовке столбца таблицы, чтобы выбрать всех агентов на странице.
• Над таблицей отобразится список массовых действий.
• Нажмите кнопку с иконкой , чтобы открыть дополнительное меню.
• Выберите действие Назначить агента на задачи инвентаризации.
• Откроется окно списка задач.
  Обратите внимание, в списке выводятся все задачи (без проверки позволяет ли тип агента выполнять данный вид задач, подробнее).
• Отметьте задачи, на которые нужно назначить агента, с помощью чекбокса .
  Вы также можете использовать чекбокс в заголовке столбца таблицы, чтобы выбрать все задачи на странице.
• Нажмите кнопку Применить, чтобы сохранить изменения.
• При выполнении действия: 
  • Если задача была назначена на всех агентов, и выбранный агент был в исключениях, то он будет удален из исключенных. Если агент не был в исключениях, то никаких действий не будет применено, так как агент и так участвует в этой задаче.
  • Если задача была назначена на определенных агентов, то к ним будут добавлены выбранные агентов (если они были в исключенных, то они будут восстановлены из исключений).

Исключение агента из задач можно сделать применительно к одному агенту или сразу к нескольким (через массовые действия).

Чтобы исключить одного агента из задач:

• Перейдите в раздел Сбор данных / Агенты с помощью меню.
• Найдите агента в таблице и нажмите на его идентификатор. Откроется карточка агента.
• Перейдите на вкладку Задачи агента.
• Страница содержит все задачи, на которые назначен агент.
• Чтобы исключить агента из одной задачи:
  • Найдите эту задачу в таблице и нажмите иконку в строке задачи.
  • Выберите пункт Исключить агента из задач инвентаризации в открывшемся меню.
• Чтобы исключить агента сразу из нескольких задач:
  • Отметьте задачи, которые нужно снять с агента, с помощью чекбокса .
    Вы также можете использовать чекбокс в заголовке столбца таблицы, чтобы выбрать все задачи на странице.
  • Над таблицей отобразится список массовых действий.
  • Нажмите на кнопку Исключить агента из задач инвентаризации над таблицей.

Чтобы исключить несколько агентов сразу из одинакового списка задач:

• Перейдите в раздел Сбор данных / Агенты с помощью меню.
• Отметьте нужных агентов с помощью чекбокса .
  Вы также можете использовать чекбокс в заголовке столбца таблицы, чтобы выбрать всех агентов на странице.
• Над таблицей отобразится список массовых действий.
• Нажмите кнопку с иконкой , чтобы открыть дополнительное меню.
• Выберите действие Исключить агента из задач инвентаризации.
• Откроется окно списка задач. Обратите внимание, в списке отображаются все задачи в системе (без проверки назначены ли на них выбранные агенты).
• Отметьте задачи, из которых нужно исключить выбранных агентов, с помощью чекбокса .
  Вы также можете использовать чекбокс в заголовке столбца таблицы, чтобы выбрать все задачи на странице.
• Нажмите кнопку Применить, чтобы сохранить изменения.
• При обработке исключения агентов из задач: 
  • Если задача была назначена на всех агентов, то выбранные агенты будут добавлены в исключенные.
  • Если задача была назначена на определенных агентов, и среди них есть выбранные для исключения, то для этих агентов в настройках задачи будет включено "Исключить". Если агент ранее не был назначен на задачу, то для него ничего не изменится.

Запрет сбора данных позволяет временно отключить сбор данных агентом без изменений настроек задач инвентаризации.

Условия выполнения действия:

• Версия агента 6.4. или выше.
• Статус агента = В сети.

Переключение сбора данных можно сделать:

• Из таблицы агентов:
  • Перейдите в раздел Сбор данных / Агенты.
  • Найдите нужного агента в таблице и нажмите иконку в строке агента в правой части таблицы.
  • Выберите действие: Разрешить сбор данных / Запретить сбор данных. Будет доступен только один вариант в соотвествии с текущим состоянием агента (например, если на текущий момент сбор данных разрешен, то будет активен только пункт Запретить сбор данных).
    Если оба варианта не активны, значит действие не поддерживается.
• Через массовые действия.
• При редактировании агента.

Вы можете удалить запись об агенте из базы данных системы, в этом случае агент перестанет отображаться в разделе.
Например, если какие-либо агенты давно не были в сети и вы не хотите, чтобы они отображались в таблице.

При этом, если после удаления агент из базы данных станет активным, то он отправит информацию о себе интеракту, после чего опять будет автоматически добавлен в базу данных и отобразится в разделе.

Удаление записи об агенте не влияет на самого агента, установленного на устройстве.

Доступно для любой версии агента и не зависит от его состояния.

Для выполнения действия:

• Перейдите в раздел Сбор данных / Агенты с помощью меню.
• Найдите агента в таблице.
• В правой части таблицы нажмите иконку в строке агента. 
  Используйте горизонтальную прокрутку, если необходимо.
• Откроется подменю.
• Выберите пункт Удалить запись.

С помощью массовых действий вы можете:

• Обновить версию агентов.
• Изменить настройки агентов:
  • Разрешить / запретить обновление.
  • Разрешить / запретить сбор данных (изменяет состояние агента).
• Назначить / исключить агента в задачах инвентаризации.
• Удалить запись об агенте из таблицы (агент с устройства при этом не будет удален).

Действие будет выполнено, если агент поддерживает данное действие.

Для выполнения массовых действий с агентами:

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