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

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

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

---

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

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

---

Требования

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

---

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

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

---

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

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

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

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

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

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

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

Индексы (indexes)

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

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

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

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

{
  "title": "Zabbix: метрики",
  "description": "описание слоя"
}

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

{
  "attributes": {
    "title": "zabbix_hosts-*"
  },
  "references": []
}

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

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

---

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

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

Перед началом установки убедитесь, что выполнена интеграция Zabbix с Smart Monitor Data Collector. На этом этапе должны быть настроены все необходимые pipeline, а также добвлены в keystore API-токен ZABBIX_API_TOKEN и пароль пользователя logstash.

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

python make_zabbix.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_zabbix.py --sm_host sm-host.my_company.ru --sm_user admin --sm_password securepassword --sm_port 9200

Шаг 3. Запуск службы Logstash

После успешного развертывания конфигурации выполните запуск службы Logstash:

sudo systemctl start logstash && sudo systemctl status logstash

или, если служба уже запущена:

sudo systemctl restart logstash && sudo systemctl status logstash

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

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

1. Индексы

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

2. Политики ISM

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

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

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

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

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

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

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

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

   • В разделе Список справочников: (Навигационное меню - Lookup Manager - Список справочников)