Перейти к основному содержимому
Версия: 5.2

Интеграция Zabbix с Smart Monitor

Оглавление​

Модуль Zabbix​

Модуль Zabbix использует данные с серверов мониторинга для построения дашбордов, инвентаризации и анализа инцидентов. Для интеграции требуется настроить Smart Monitor Data Collector и добавить API-токен Zabbix.

Smart Monitor Data Collector основан на Logstash, в дальнейшем в тексте может использоваться как альтернативное имя.

Предварительные требования​

Перед началом настройки убедитесь, что выполнены следующие условия:

  • Smart Monitor Data Collector установлен по стандартному пути:
/app/logstash/
  • Конфигурационные файлы (далее — pipeline) размещаются по пути:
/app/logstash/config/conf.d
  • Для работы вспомогательных скриптов используется Python 3:
/app/logstash/utils/python/bin/
Обратите внимание!

Если используются нестандартные пути установки, проверьте все pipeline и внесите корректировки при необходимости.

Настройка API-токена Zabbix​

Получите API-токен с рабочего сервера Zabbix через веб-интерфейс:

  • Перейдите Навигационное меню - Users - API tokens

Получение API-токена Zabbix

  • Нажмите в правом верхнем углу Create API token
  • Укажите название токена, пользователя Zabbix, а также дату и время окончания срока действия токена

Настройка API-токена Zabbix

  • Нажмите Add, после чего скопируйте Auth token и сохраните его в безопасном месте

Создание API-токена Zabbix

Настройка узла Smart Monitor Data Collector​

Для работы pipeline Zabbix необходимы параметры, которые хранятся в keystore на узле Smart Monitor Data Collector.

Добавление параметров в keystore​

В keystore требуется добавить:

  • ZABBIX_API_TOKEN — API-токен для взаимодействия с Zabbix
  • ES_PWD — пароль пользователя logstash

Для внесения их в keystore выполните:

sudo -u logstash /app/logstash/bin/logstash-keystore add ZABBIX_API_TOKEN
sudo -u logstash /app/logstash/bin/logstash-keystore add ES_PWD

Проверьте наличие параметров в keystore командой:

sudo -u logstash /app/logstash/bin/logstash-keystore list

Пример результата выполнения команды:

user@RAM-debian12:~$ sudo -u logstash /app/logstash/bin/logstash-keystore list

es_pwd
zabbix_api_token

Размещение pipeline Zabbix​

Содержимое каталога с pipeline модуля Zabbix необходимо разместить по пути:

/app/logstash/config/conf.d

Полключение pipeline выполняeтся в файле:

/app/logstash/config/pipelines.yml

Необходимо добавить в него следующие строки:

### Zabbix

- pipeline.id: zabbix-events
  path.config: "/app/logstash/config/conf.d/zabbix-events.conf"

- pipeline.id: zabbix-items
  path.config: "/app/logstash/config/conf.d/zabbix-items.conf"

- pipeline.id: zabbix-hosts
  path.config: "/app/logstash/config/conf.d/zabbix-hosts.conf"

- pipeline.id: zabbix-triggers
  path.config: "/app/logstash/config/conf.d/zabbix-triggers.conf"

- pipeline.id: zabbix-groups
  path.config: "/app/logstash/config/conf.d/zabbix-groups.conf"

Настройка pipeline Zabbix​

Для настройки модуля Zabbix требуется указать значения двух параметров pipeline:

  • <ZABBIX_SERVER_IP> — адрес сервера Zabbix, с которого осуществляется сбор данных
  • <OPENSEARCH_HOSTS> — адрес узла или кластера Smart Monitor Data Storage, в который будут отправляться собранные данные
Обратите внимание!

На этом этапе не перезапускайте службу Logstash. Для корректной интеграции сначала установить утилиту zabbix_ko_maker, которая создает все необходимые сущности Smart Monitor. Перезапуск службы будет произведен после установки утилиты. Подробнее — в соответствующем разделе Zabbix: Установка и настройка конфигурации.

На данном этапе настройку узла Smart Monitor Data Collector можно считать завершенной.