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

Zabbix

Подключение Zabbix в качестве источника событий​

Для подключения источника данных типа Zabbix, произведите конфигурацию со стороны Zabbix:

  1. Создайте группу пользователей с правами на чтение к тем узлам сети, данные о которых хотите направлять в Monq.
  2. Для создания перейдите в раздел Администрирование -> Группы пользователей и нажмите Создать группу, далее введите имя и выберите группы узлов сети во вкладке Права доступа.
  3. Создайте пользователя в созданной группе. Для этого перейдите в раздел Администрирование -> Пользователи и нажмите Создать пользователя, в открывшемся окне введите данные пользователя и выберите группу, в которую его необходимо добавить. Скопируйте псевдоним и пароль пользователя для дальнейшей настройки.

Далее перейдите в раздел "Мастер настройки" Monq и выполните следующие действия:

  1. Из списка доступных контент-паков выберите - "Zabbix Data Stream"

  2. Ознакомьтесь с описанием и инструкциями контент-пак

  3. Инициируйте запуск сценария установки контент-пака кнопкой "Запустить сценарий"

  4. Заполните параметры для сборщика данных:

    • Введите адрес вашего Zabbix API в следующем формате http://zabbix.example.com/api_jsonrpc.php
    • Введите логин Zabbix
    • Введите пароль Zabbix

    Изображение

    ⚠️ Если пропустить настройку сборщика данных в данном месте, потребуется перейти в раздел "Сборщики данных", выбрать нужный сборщик и заполнить параметры вручную.

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

  5. Запустите сценарий, нажав соответствующую кнопку.

На данном этапе настройка завершена. По завершению работы сценария будут созданы поток данных и необходимые сборщики, которые сразу начнут свою работу.

В созданный поток данных будут поступать только вновь сгенерированные данные в Zabbix. Исторические данные загружены не будут.

В случае разрыва соединения, предусмотрен механизм загрузки всех событий, произошедших за период отсутствия связи.

Настройка Zabbix для отправки событий в Monq (webhook)​

Конфигурация производится на стороне Zabbix. Monq в данном случае является принимающей стороной.

  1. Добавьте новый поток данных и перейдите на страницу его настройки
  2. Скопируйте API-ключ – он понадобится при настройке Zabbix
  3. Перейдите в Zabbix
  4. Настройте отправку сообщений из источника данных (в данном случае – Zabbix):

    • В веб-интерфейсе Zabbix 6.0 перейдите в Администрирование > Способы оповещений и создайте новый тип оповещения.
      Введите имя, выберите тип Webhook.
      Заполните таблицу Параметры – содержимое JSON-файла, который будет направлен в Monq:

      EventID: {EVENT.ID}
      EventName: {EVENT.NAME}
      EventSeverity: {EVENT.SEVERITY}
      HostName: {HOST.NAME}
      TriggerStatus: {TRIGGER.STATUS}

      Полный список доступных макросов для передачи можно найти в документации Zabbix.

    • В поле скрипт скопируйте код на языке JavaScript, формирующий и отправляющий POST-запрос в API вашего пространства Monq:

      💡 Скрипт актуален для версии Zabbix 5.4 и выше

      var request = new HttpRequest();
      params = JSON.parse(value);
      request.addHeader('Content-Type: application/json');
      response = request.post('https://{GLOBAL_DOMAIN}/api/public/cl/v1/stream-data?streamKey={API-KEY}', JSON.stringify(params));
      return 'OK';

      {GLOBAL_DOMAIN} – адрес вашего пространства Monq, например, sm.monq.cloud.

      {API-KEY} – API-ключ.

      Изображение

  5. Сохраните новый способ оповещения. В разделе Настройка -> Действия настройте реагирование на события Zabbix и в качестве операции выберите созданный метод оповещения.

Используя данный пример, вы можете реализовать приём данных из любого источника, поддерживающего Webhook - справка.

Пример настройки Zabbix для отправки метрик в Monq​

Используя данный пример, вы можете реализовать приём метрических рядов из Zabbix.

Конфигурация производится на стороне Zabbix. Monq в данном случае является принимающей стороной.

Создайте новый поток данных или используйте существующий в Monq. Из этого потока данных потребуется только API-ключ. Поток должен быть с типом "Метрики".

Описание формата принимаемых данных в Monq.

Поддерживается в версиях Zabbix 6.4 и выше.

В веб интерфейсе Zabbix перейдите в раздел "Администрирование" - "Общие" - "Коннекторы"

и сконфигурируйте коннектор следующим образом:

URL: https://<MONQ-FQDN>/api/public/mcs/v1/metrics-collector/zabbix/stream-ndjson?streamKey=<API-ключ>

  • <MONQ-FQDN> замените на адрес своей инсталяции
  • <API-ключ> замените на API-ключ нужного потока данных

Изображение

⚠️ Необходимо, чтобы в конфигурационном файле Zabbix Server был включен хотя бы один экземпляр StartConnectors (документация Zabbix).