Pult / Zabbix

Последняя версия: 1.3.0

Дистрибутив: образ плагина Pult / Zabbix

Описание

Плагин для интеграции Графини с отечественной системой мониторинга «Пульт» и совместимыми сценариями на базе Zabbix. В метаданных плагина он публикуется как Pult / Zabbix.

Плагин предоставляет стандартный конструктор источника данных с динамическими полями. При проверке подключения используется собранная конфигурация источника данных, после чего выполняется проверка доступности API.

Настройка

Ниже приведены скриншоты формы создания источника данных Pult / Zabbix из интерфейса Графини.

Базовая форма

Поля источника данных

Ниже перечислены поля, которые формируются в конструкторе источника данных.

Название в UI	Код поля	Тип	Обязательность	Примечание
URL	url	text	обязательно	Адрес Пульта, валидируется как URL
Порт	port	number	необязательно	Диапазон 80..49151
Пропустить проверку TLS	skipTls	radio	обязательно	Триггерное поле
Метод аутентификации	authType	radio	обязательно	Триггерное поле
Использовать тренды	useTrends	radio	обязательно	Триггерное поле
Время жизни кеша	ttl	number	необязательно	В секундах, 0 означает без кеширования
Максимальное количество измерений запроса истории/трендов	historyMaxPoints	number	необязательно	Ограничение на объём точек при запросе

Динамические поля и зависимости

Дополнительные поля появляются только после выбора значений в триггерных полях. В документации ниже используются именно те подписи, которые видит пользователь в интерфейсе.

1. Поле Пропустить проверку TLS:

• если выбрано значение Проверять, появляется поле TLS-сертификат
• поле TLS-сертификат отображается как многострочное текстовое поле
• назначение: передача TLS-сертификата для валидации источника данных

2. Поле Метод аутентификации:

• если выбрано значение Токен, появляется поле API токен
• если выбрано значение Логин и пароль, появляются поля Пользователь и Пароль

3. Поле Использовать тренды:

• если выбрано значение Включено, появляются поля Тренды используются для запросов данных старше (дней) и Тренды используются для запросов данных диапазоном больше (дней)
• Тренды используются для запросов данных старше (дней): через сколько дней использовать тренды вместо истории, диапазон 1..30
• Тренды используются для запросов данных диапазоном больше (дней): при каком размере временного диапазона использовать тренды, диапазон 1..7

Аутентификация по токену

Упрощённый вариант без TLS-проверки и без трендов

Правила заполнения, важные для проверки подключения

• URL обязателен
• Порт необязателен
• должен быть заполнен либо API токен, либо пара Пользователь + Пароль
• если не передан ни токен, ни логин/пароль, плагин завершает обработку ошибкой Token or login&password must be filled in

Порядок создания источника данных

1. Откройте раздел Источники данных и нажмите Добавление источника.
2. В поле Источник данных укажите понятное имя подключения.
3. В поле Тип выберите Pult / Zabbix.
4. Заполните URL и при необходимости Порт.
5. В поле Пропустить проверку TLS выберите: Проверять, если требуется проверка сертификата, и вставьте сертификат в поле TLS-сертификат; Игнорировать, если проверка сертификата не нужна.
6. В поле Метод аутентификации выберите один из вариантов: Токен, если подключение должно выполняться по API-токену; Логин и пароль, если подключение должно выполняться по учётным данным пользователя.
7. При необходимости настройте Использовать тренды, Время жизни кеша и Максимальное количество измерений запроса истории/трендов.
8. Нажмите Проверить соединение.
9. После успешной проверки нажмите Сохранить.

Пример заполнения с токеном

• URL: адрес API Пульта или Zabbix
• Порт: порт API, если он не входит в URL
• Пропустить проверку TLS: Игнорировать или Проверять в зависимости от схемы подключения
• Метод аутентификации: Токен
• API токен: действующий токен доступа

Пример заполнения с логином и паролем

• URL: адрес API Пульта или Zabbix
• Порт: порт API, если он не входит в URL
• Пропустить проверку TLS: Игнорировать или Проверять
• Метод аутентификации: Логин и пароль
• Пользователь: логин пользователя
• Пароль: пароль пользователя

Пример заполнения с TLS

Если в поле Пропустить проверку TLS выбрано Проверять, дополнительно заполните поле TLS-сертификат. В него вставляется сертификат в текстовом виде, начиная с --- BEGIN CERTIFICATE ---.