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

Для автоматизированного развертывания инфраструктурных объектов модуля APM используется скрипт make_apm.py.
Он входит в состав пакета apm_ko_maker и размещен в каталоге bin.

Основные задачи утилиты

• развертывание объектов знаний (сущностей Smart Monitor)
• создание шаблонов индексов
• создание индексов
• развертывание политик управления состоянием индексов (ISM)

---

Требования

• Python 3.x
• установленные зависимости:
  • requests
  • urllib3
• доступ к кластеру Smart Monitor с правами администратора

---

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

./
├── bin/                   # Скрипты установки и развертывания
├── data/                  # Конфигурационные файлы
│   ├── core/              # Слои ресурсно-сервисной модели (РСМ)
│   ├── index-patterns/    # Паттерны индексов
│   ├── indexes/           # Конфигурации индексов
│   ├── inv/               # Настройки инвентаризации
│   ├── sm_*/              # Сущности Smart Monitor
│   ├── index_templates/   # Шаблоны индексов
│   └── ism_policies/      # Политики ISM
├── templates/             # Шаблоны метрик РСМ

---

Форматы конфигурационных файлов

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

Настройки в директориях indexes и ism_policies предназначены для демонстрации. Перед продуктивной установкой их следует адаптировать под требования хранения и ротации данных.

Сущности Smart Monitor (sm_*)

{
  "_meta": { 
	  // мета-данные
  },
  // конфигурация
}

Шаблоны индексов (index_templates)

{
  "name": "имя_шаблона",
  "index_template": {
    // конфигурация шаблона
  }
}

Индексы (indexes)

{
  "имя_индекса": {
    // конфигурация индекса
  }
}

Политики ISM (ism_policies)

{
  "policy": {
    "policy_id": "otel-apm-ism-policy",
    // конфигурация
  }
}

Слои РСМ (core/rsm/layers)

{
  "title": "название слоя",
  "description": "описание слоя"
}

Паттерны индексов (index-patterns)

{
  "attributes": {
    "title": "название паттерна"
  },
  "references": []
}

Инвентаризация (inv)

• inv/inventories — конфигурации активов
• inv/relationSettings — связи между активами

---

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

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

python make_apm.py --sm_host <хост> --sm_user <пользователь> --sm_password <пароль> [--sm_port <порт>]

Параметр	Обязательный	Тип	По умолчанию	Описание
--sm_host	Да	string	—	Хост кластера Smart Monitor
--sm_port	Нет	int	9200	Порт подключения
--sm_user	Да	string	—	Имя пользователя
--sm_password	Да	string	—	Пароль пользователя

Пример:

python make_apm.py --sm_host sm-host.my_company.ru --sm_user admin --sm_password securepassword --sm_port 9200

---

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

После запуска проверьте, что настройки применились:

1. Индексы

   • навигация: Навигационное меню - Параметры системы - Управление индексами - Индексы
   • 

2. Политики индексации

   • навигация: Навигационное меню - Параметры системы - Управление индексами - Политики индекса
   • политика otel-apm-ism-policy
   • 

3. Управляемые индексы

   • навигация: Навигационное меню - Параметры системы - Управление индексами - Управляемые индексы
   • 

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

   • навигация: Навигационное меню - Настройки модулей - Шаблоны настроек индексов
   • 

5. Справочники

   • навигация: Навигационное меню - Lookup Manager - Список справочников
   • должны присутствовать:
     • dim_apm_service
     • link_apm_source_service_dest_service