Установка утилиты

Оглавление

• Общее описание
• Последовательность установки
  • Шаг 0. Требования утилиты
  • Шаг 1. Установка зависимостей утилиты
  • Шаг 2. Развертывание объектов утилиты
  • Шаг 3. Проверка загрузки объектов утилиты
    • 1. Шаблоны индексов
    • 2. Паттерны индексов
    • 3. Актив инвентаризации
    • 4. Метрики здоровья
• Удаление объектов

---

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

Для развертывания объектов модуля AI Observability используется утилита ai_observability_ko_maker.

Утилита устанавливает:

• шаблоны индексов gen_ai_traces*, gen_ai_events*, gen_ai_metrics*, gen_ai_gpu_metrics*, gen_ai_cost*
• паттерны индексов для всех gen_ai_* индексов
• актив инвентаризации AI Observability: GPU
• 6 метрик здоровья

---

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

Шаг 0. Требования утилиты

• Python 3.x
• доступ к кластеру Smart Monitor с правами администратора
• сетевой доступ одновременно к frontend API (порт 5601) и OpenSearch API (порт 9200)

Шаг 1. Установка зависимостей утилиты

./bin/install_dependencies.sh

Шаг 2. Развертывание объектов утилиты

./bin/make_ai_observability.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	Да	—	IP или hostname Smart Monitor
--sm_api_port	Нет	5601	Порт frontend API (saved objects, inventory, метрики МАЯК)
--sm_cluster_port	Нет	9200	Порт OpenSearch API (index templates)
--sm_user	Да	—	Имя пользователя
--sm_password	Да	—	Пароль пользователя

Дополнительные параметры:

• --skip-index-templates, --skip-index-patterns, --skip-inventory, --skip-rsm-metrics — пропустить соответствующий тип объектов
• --dry-run — показать, что будет сделано, без отправки запросов

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

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

Шаг 3. Проверка загрузки объектов утилиты

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

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

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

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

После загрузки проверьте наличие паттернов индексов:

Навигационное меню - Параметры системы - Настройки модулей - OPENSEARCH - Паттерны индексов

3. Актив инвентаризации

После загрузки проверьте наличие актива инвентаризации:

Навигационное меню - Inventory - Активы

4. Метрики здоровья

После загрузки проверьте наличие глобальных метрик в модуле МАЯК:

Навигационное меню - МАЯК - Метрики

---

Удаление объектов

Для удаления всех развернутых объектов используется обратный скрипт:

./bin/remove_ai_observability.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>'