Изменение конфигурации

Изменение конфигурации

  1. Для Windows и Linux отключите самозащиту агента.

  2. Остановите службу агента:

    • Для Windows — через системное приложение Службы.

    • Для Linux — с помощью команды:

      systemctl stop bzsenagent
    • Для macOS — с помощью команды:

      launchctl unload /Library/LaunchDaemons/zone.bi.sensors.agent.plist
  3. В каталоге агента запустите команду с необходимыми параметрами:

    • Пример для Windows:

      bzsenagent.exe config -a sensors.sensors:9992 -s sensors.sensors:9991 -t 15s -p 300s -l debug
    • Пример для Linux и macOS:

      bzsenagent config -a sensors.sensors:9992 -s sensors.sensors:9991 -t 15s -p 300s -l debug
  4. Запустите службу агента:

    • Для Windows — через системное приложение Службы.

    • Для Linux — с помощью команды:

      systemctl start bzsenagent
    • Для macOS — с помощью команды:

      launchctl load /Library/LaunchDaemons/zone.bi.sensors.agent.plist

Параметры команды

Параметр

Ключ

Примеры значений

Адрес и номер порта сервера управления для неавторизованных агентов

Короткий:

-a

Длинный:

--authority-address

  • IPv4-адрес: 1.2.3.4:9992

  • IPv6-адрес: [::ae21:ad12]:9992

  • DNS-имя: sensors.localdomain:9992

Адрес и номер порта сервера управления для авторизованных агентов

Короткий:

-s

Длинный:

--sensors-address

  • IPv4-адрес: 1.2.3.4:9991

  • IPv6-адрес: [::ae21:ad12]:9992

  • DNS-имя: sensors.localdomain:9991

Период опроса сервера агентом

Короткий:

-p

Длинный:

--polling-period

  • 10s (min)

  • 300s (default)

Таймаут подключения к серверу

Короткий:

-t

Длинный:

--dial-timeout

  • 5s (min)

  • 15s (default)

Уровень логирования

Короткий:

-l

Длинный:

--log-level

  • trace

  • debug

  • info

  • warn

  • error

Адрес и номер порта компонента отправки телеметрии для авторизованных агентов

Короткий:

-r

Длинный:

--relay-address

  • IPv4-адрес: 1.2.3.4:9994,

  • IPv6-адрес: [::ae21:ad12]:9992,

  • DNS-имя: sensors.localdomain:9994

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

Короткий:

-h

Длинный:

--help

Тип идентификации агента

(Особенности ниже)

Длинный:

--id-type

  • agent-id

  • name-id

  • os-id

  • name+os-id (используется по умолчанию)

Не удалять файлы после их загрузки в хранилище агента

Длинный:

--keep

Путь к файлу конфигурации

Короткий:

-c

Перевод агента в автономный режим работы (Особенности ниже)

Длинный:

--portable

  • true

  • false

Подключение GUI

(только Windows и macOS)

Длинный:

--gui-enabled

  • true

  • false

Особенности параметров

Тип идентификации агента

Изменить тип идентификации агента можно, только если при начальной конфигурации было задано значение agent-id.

Перевод агента в автономный режим работы

При переводе агента в автономный режим работы:

  • данные о задачах и источниках данных сохраняются;

  • ранее накопленные события стираются

Для возврата агента в обычный режим работы необходимо задать адрес и номер порта сервера — ключи -a и -s.