Управление сенсорами

Сенсоры – это скрипты, которые выполняют сбор данных при инвентаризации. Они могут быть:

• Системные – это предустановленные сенсоры, которые используется системой по умолчанию.
  Вы можете их отредактировать с учетом каких-либо персональных настроек вашей системы. После редактирования скрипт можно вернуть к начальному состоянию с помощью сброса настроек.
• Несистемные – это полностью персонализированные сенсоры, которые вы создаете самостоятельно.

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

Поддерживаемые типы скриптов:

• Powershell скрипт
• Shell скрипт
• SQL скрипт
• Внутренний скрипт - скрипт, исполняемый агентом (Файлы, IPMI, LDAP, PortCheck, RestApi, WMI)

Один сенсор может содержать несколько скриптов разных типов.

Код скрипта может быть задан отдельно в зависимости от платформы, на которой он будет работать.

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

Далее:

• Для создания сенсора нажмите кнопку Создать сенсор в правом верхнем углу.
• Для редактирования сенсора нажмите на его название в таблице.
• Для удаления сенсора нажмите на иконку в строке сенсора в таблице.

Для создания сенсора:

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

• В поле Наименование сенсора введите название сенсора, указав в нем любое удобное вам значение.

Код скрипта может быть одинаковым для всех платформ, или задан по отдельности для каждой платформы, на которой он будет исполняться.

Если код скрипта одинаковый для всех платформ:

• Включите чекбокс Для всех платформ в блоке Общие настройки.
• Переходите к заполнению содержания скрипта в основной части экрана, как описано далее.

Если код скрипта зависит от платформы, на которой он исполняется:

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

• Заполните поля в основной части страницы:
  • Наименование скрипта - используется, если в одном сенсоре объединено несколько скриптов. Вы можете оставить в поле значение по умолчанию или указать любое удобное вам значение.
  • Тип скрипта - выберите значение в выпадающем списке в зависимости от того, кто является исполнителем скрипта:
    • Powershell скрипт
    • Shell скрипт
    • SQL скрипт
    • Внутренний скрипт - используется в случае, если скрипт полностью выполняется на уровне агента. Например, к этой группе относятся: Файлы, IPMI, LDAP, PortCheck, RestApi, WMI скрипты.
  • Напишите код скрипта в текстовом поле под первыми двумя полями.
  • Тип результата - выберите значение в выпадающем списке в зависимости от того, в каком формате скрипт должен возвращать данные. 
    Если вы используете несколько скриптов в одном сенсоре и хотите, чтобы два скрипта выполнялись последовательно, а полученные данные дополнялись, то используйте в первом скрипте тип результата "Список ...". В ином случае данные будут перезаписаны / не полностью сохранены. Например, если вы в первом  скрипте выберите тип результата "справочник формата ключ-значение", во втором - "список справочников формата ключ-значение", то после отработки второго скрипта сохранится только один справочник, как настроено в первом скрипте, а прочие данные не будут сохранены.
  • Предварительный просмотр - поле содержит пример результата для выбранного типа. Пример заполнится автоматически после того, как вы выберете тип результата. Не требуется редактировать.
  • Параметры - дополнительные параметры для обработки результата, заполняются, если требуется:
    • Параметр-ключ для данных в одной строке - наименование параметра, в который будут записаны данные сенсора с типом результата "Строка".
      Например, в настройках скрипта указано: тип результата = "Строка", параметр-ключ для данных в одной строке = "Domain".
      Сенсор собрал данные = "my domain".
      Итоговый результат сохранения данных:

      "Domain":"my domain 1"

    • Параметр-ключ для данных в виде списка строк - наименование параметров, в которые будут записаны данные сенсора с типом результата "Список строк".
      Например, в настройках скрипта указано: тип результата = "Список строк", параметр-ключ для данных в виде списка строк= "Domain".
      Сенсор собрал данные = "my domain 1", "my domain 2", "my domain 3".
      Итоговый результат сохранения данных:

      [
      "Domain":"my domain 1",
      "Domain":"my domain 2",
      "Domain":"my domain 3"
      ]

    • Разделитель между собранными данными - знак нестандартного разделителя, в случае, если данные приходят, но не разделяются по параметрам, так как система не опознает переданный разделитель. Например, если сенсор собрал данные "my domain 1;my domain 2", то в качестве разделителя нужно указать ;
    • Список аргументов - отображает список параметров командной строки, передаваемый выполняемому скрипту сенсора.
• Добавьте дополнительные скрипты в сенсор, если требуется, узнайте больше об этой возможности далее.
• Нажмите кнопку Сохранить внизу страницы.

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

С помощью этой возможности вы можете:

• Собирать данные сначала одним способом (например, через PowerShell), затем дополнять их данными, собранными другим способом (например, через WMI).
• Собирать данные с помощью разных версий PowerShell, например, первый скрипт написан для одной версии PowerShell, а второй для другой.
• Обрабатывать ошибки сбора данных (например, если первый скрипт не собрал данные одним способом, попробовать другой вариант сбора данных).

Узнайте подробнее об этой возможности »

После того, как сенсор создан или изменен, его необходимо подключить в задаче инвентаризации (или проверить его настройки). Узнайте об этом подробнее.