Servers: Установка и настройка конфигурации

Оглавление

• Общее описание
• Назначение утилиты
• Требования
• Структура проекта
• Последовательность установки
  • Шаг 1. Интеграция Smart Monitor Data Collector и SmartBeatManager
  • Шаг 2. Подготовка окружения
  • Шаг 3. Запуск установки конфигурации
  • Шаг 4. Проверка результата в интерфейсе

Общее описание

Для развертывания инфраструктурных объектов модуля Servers используется утилита servers_ko_maker. В каталоге bin размещены основной скрипт установки make_servers.py и вспомогательный скрипт install_dependencies.sh для подготовки Python-окружения и зависимостей.

---

Назначение утилиты

• создание базовых технических зависимостей модуля
• создание шаблонов индексов
• создание паттернов индексов
• создание настроек инвентаризации

---

Требования

• Python 3.12 и выше
• Python-зависимости утилиты
• Доступ к кластеру Smart Monitor с правами администратора

---

Структура проекта

./
├── bin/                    # Скрипты установки и подготовки зависимостей
├── data/
│   ├── index_templates/    # Шаблоны индексов модуля
│   ├── index-patterns/     # Паттерны индексов
│   └── inv/
│       └── inventories/    # Настройки инвентаризации
├── pyproject.toml          # Описание Python-пакета и зависимостей
└── README.md               # Инструкция по запуску

---

Последовательность установки

Шаг 1. Интеграция Smart Monitor Data Collector и SmartBeatManager

Перед запуском утилиты убедитесь, что выполнены действия из раздела Servers: Интеграция. На этом этапе должны быть подготовлены:

• pipeline для Logstash
• конфигурации приложений SmartBeatManager
• настройки serverclasses

Шаг 2. Подготовка окружения

Перейдите в корневой каталог утилиты и выполните подготовку окружения.

Рекомендуемый способ:

chmod +x bin/install_dependencies.sh
./bin/install_dependencies.sh

Скрипт install_dependencies.sh:

• создает виртуальное окружение .venv
• обновляет pip
• устанавливает зависимости утилиты

Альтернативно можно выполнить установку вручную:

python3 -m venv .venv
source .venv/bin/activate
pip install .

Шаг 3. Запуск установки конфигурации

python bin/make_servers.py \
  --sm_host <SMART_MONITOR_HOST> \
  --sm_api_port <SMART_MONITOR_API_PORT> \
  --sm_cluster_port <OPENSEARCH_PORT> \
  --sm_user <SMART_MONITOR_USER> \
  --sm_password '<SMART_MONITOR_PASSWORD>'

Параметр	Обязательный	Тип	По умолчанию	Описание
--sm_host	Да	string	—	Сервер Smart Monitor
--sm_api_host	Нет	string	значение --sm_host	Сервер API Smart Monitor
--sm_api_port	Да	int	—	Порт API Smart Monitor
--sm_cluster_host	Нет	string	значение --sm_host	Сервер OpenSearch
--sm_cluster_port	Да	int	—	Порт OpenSearch
--sm_user	Да	string	—	Имя пользователя
--sm_password	Да	string	—	Пароль пользователя

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

--sm_api_port используется для frontend API и saved objects, а --sm_cluster_port — для загрузки index templates. Если frontend API и OpenSearch опубликованы на разных серверах, можно явно задать --sm_api_host и --sm_cluster_host.

Шаг 4. Проверка результата в интерфейсе

После успешного выполнения утилиты проверьте наличие созданных объектов:

1. Шаблоны индексов

   • В разделе Шаблоны: (Навигационное меню - Параметры системы - Управление индексами - Шаблоны)

2. Паттерны индексов

   • В разделе Паттерны индексов: (Навигационное меню - Параметры системы - Настройки модулей - OpenSearch - Паттерны индексов)

3. Инвентаризация

   • В разделе Активы: (Навигационное меню - Inventory - Активы)

После этого можно переходить к загрузке контентного модуля.