Smart Beat для Linux

Обратите внимание

Smart Beat может работать с любой версией ElasticBeat, но если Вы планируете отправлять данные напрямую в OpenSearch, то версия ElasticBeat должна быть 7.12.1 (или 7.10.2 - более стабильная версия). Если планируется использовать Logstash, то версия ElasticBeat не имеет значения. Подробнее на официальном сайте.

Условные обозначения

• $HOME_SB - домашняя директория установки Smart Beat, для Linux - /app/smartBeat/, для Windows - C:\Program Files\smartBeat\

Установка и запуск Smart Beat

Обратите внимание!

Есть две версии, x32 и x64, используйте соответствующую версию разрядности ОС

Для установки Smart Beat на ОС Linux, необходимо открыть терминал под пользователем root для выполнения команд. Перед распаковкой архива, необходимо создать директорию:

mkdir /app/smartBeat

Для распаковки архива выполните следующую команду для x64:

tar -xzf <путь к архиву>/smartBeat_x64.tar.gz -C /app/smartBeat

Или для версии x32:

tar -xzf <путь к архиву>/smartBeat_x32.tar.gz -C /app/smartBeat

Создайте пользователя для Smart Beat:

useradd smartbeat

Создайте сервис Smart Beat, выполнив следующие команды:

cd /app/smartBeat
./smartBeat install
chown -Rf smartbeat:smartbeat /app/smartBeat

Для запуска Smart Beat, выполните следующую команду:

systemctl start smartBeat.service

Для того чтобы узнать работает ли сервис, необходимо выполнить команду:

systemctl status smartBeat.service

Дополнительные настройки

Для использования готовых сертификатов и закрытого ключа Smart Beat нужно выполнить следующие действия:

1. Остановить службу Smart Beat через systemd
2. В директории ${HOME_SB}/cert/ удалить все существующие сертификаты и закрытые ключи
3. В эту же директорию ${HOME_SB}/cert/ перенести существующий сертификат ЦС, сертификат и закрытый ключ SmartBeat
4. Отредактировать при необходимости конфигурационный файл ${HOME_SB}/config/config.yaml:
   1. ssl.cert_ca - указать имя сертификата x509 ЦС
   2. ssl.node_cert - имя файла сертификата x509 SmartBeat
   3. sl.node_key - имя файла закрытого ключа SmartBeat
5. Запустить службу Smart Beat через systemd

Для того, чтобы сменить пользователя, под которым работает Smart Beat, нужно сделать следующие действия:

1. Выключить сервис Smart Beat через systemd
2. Сменить владельца директории ${HOME_SB} и всех вложенных файлов и папок
3. Добавить разрешение на чтение всех необходимых файлов новому пользователю Smart Beat
4. Отредактировать файл systemd /etc/systemd/system/smartBeat.service и исправить поле User на нового пользователя
5. Запустить сервис systemd

Для того, чтобы изменить GUID Smart Beat, нужно выполнить сделать следующие действия:

1. Остановить службу Smart Beat через systemd
2. В директории ${HOME_SB}/config/ удалить файл guid.yml
3. Отредактировать конфигурационный файл ${HOME_SB}/config/config.yaml:
   1. guid_salt - указать необходимую "соль" (должна отличаться от предыдущего значения), рекомендуется использовать значение из токенов <IP> <MAC>
4. Запустить службу Smart Beat через systemd

Настройка конфигурационного файла config.yaml

Конфигурационный файл Smart Beat находится в директории config, куда был установлен Smart Beat и состоит из следующих параметров:

примечание

guid_salt является необязательным параметром.

Параметр	Описание	Значение по умолчанию
guid_salt	Соль при генерации GUID для Smart Beat. Настройка параметра требуется в случае если используются виртуальные машины и они копируются. Формат строки: <IP> <MAC>
heartbeat.min_condition	Минимальная частота подключения Smart Beat.	1m0s (1 минута)
heartbeat.multiplier	Множитель минимальной частоты подключения.	2
heartbeat.max_condition	Максимальная частота подключения.	1h0m0s (1 час)
manager.host	Хост (IP-адрес или DNS имя) Smart Beat Manager.	localhost
manager.port	Порт Smart Beat Manager.	7767
rotation.rotation_time	Частота ротации файла логирования.	24h (24 часа)
rotation.max_age	Время жизни файла логирования.	168h (1 неделя)
rotation.max_size	Ограничение размера файла логирования.	10485760 (10 Мб)
rotation.log_level	Уровень логирования.	info
server.enable	Доступ к REST API endpoints Smart Beat.	false
server.port	Порт для подключения к REST API Smart Beat.	7768
server.verify	Безопасное подключение к REST API Smart Beat.	false
ssl.verify	Проверка ssl-сертификатов при безопасном подключении к Smart Beat Manager.	false
ssl.enable	Безопасное подключение к Smart Beat Manager.	true
ssl.cert_ca	Путь до ЦС сертификата.
ssl.key_ca	Путь до ЦС ключа.
ssl.node_cert	Путь для генерации node сертификата.	./cert/node-cert.pem
ssl.node_key	Путь для генерации node ключа.	./cert/node-key.pem