- ПО Zabbix
Руководство по настройке получения данных в Zabbix из платформы Inspark IoT - ПО Обь
Руководство по настройке получения данных от контроллеров ПО Обь (мониторинг лифтов) - ПО Пульсар
Руководство по настройке получения данных от АСКУ ПУЛЬСАР
¶ ПО Zabbix
¶ 1. Общие сведения
Zabbix — свободная система мониторинга статусов разнообразных сервисов сети, серверов и сетевого оборудования. Платформы Inspark IoT может выступать эффективным централизованным источником данных о состоянии оборудования инфраструктуры организации для Zabbix. Интеграция между системами осуществляется за счет использования подготовленных шаблонов для Zabbix. Шаблоны используют REST API Inspart IoT с типом доступа HTTP agent.
Автоматизация процесса заведения объектов мониторинга платформы Inspark IoT (датчиков) в Zabbix осуществляется способом добавления к конфигурации Zabbix Host шаблона (Templates) объектов Inspark IoT. Добавляемый шаблон содержит правила обнаружения датчиков платформы Inspark IoT, прототипы триггеров контроля состояния и графиков данных.
Доступны следующие шаблоны интеграции:
• zbx_INSPARK_Params_Object – получение всех измеряемых параметров объекта;
• zbx_INSPARK_Params_Sensors – получение измеряемых параметров по ID датчиков в Inspark IoT.
¶ 2. Импорт шаблонов в Zabbix
Операция выполняется в интерфейсе Zabbix.
Для импорта шаблонов выполните следующие шаги:
- Перейдите в: Configuration → Templates.
- Нажмите на кнопку Import.
- Выберите импортируемый файл. Нажмите на кнопку Import.
- Откроется экранная форма с содержимым файла импорта. Нажмите на кнопку Import.
- Выполнить шаги 2-4 для всех файлов импортируемых шаблонов.
- По завершению процесса импорта шаблона будет добавлена группа хостов
«Inspark». Для отображения группы добавленных шаблонов необходимо в поле«Host groups»выбрать добавленную группу и нажать кнопку «Apply».
¶ 3. Добавление узла сети (хоста) сбора данных
Порядок добавления узла сети (хоста) сбора данных. Операция выполняется в интерфейсе Zabbix.
-
Перейдите в: Configuration → Hosts.
-
Нажмите кнопку с надписью «Create host».
-
Заполните поля формы:
Host name– строка описывающая объект мониторинга;Groups– нажмите кнопку «Select» и выберите группу «Inspark», нажмите кнопку Select;Interfaces– нажмите кнопку «Add» с выбором значения IPMI.
• IP address или DNS name – адрес хоста Inspark IoT. Данные для информации, при опросе датчиков значение поля не используется;
• Port – порт хоста доступа к Inspark IoT. Данные для информации, при опросе датчиков значение поля не используется.
-
Нажмите кнопку добавления нового хоста «Add», расположенную в нижней части экранной формы.
¶ 4. Шаблон «Получение всех измеряемых метрик объекта»
(Template zbx_inspark_params_object_v1.yaml)
Шаблон позволяет автоматизировать процесс добавления измеряемых параметров объекта Inspark IoT в систему мониторинга Zabbix. Идентификация объекта мониторинга осуществляется по его ID в Inspark IoT. При добавлении шаблона к хосту проводится анализ полученных данных и осуществляется автоматическое формирование списка измеряемых параметров в раздел Items выбранного хоста.
¶ 4.1. Добавление шаблона интеграции
Порядок добавления и настройки интеграции. Операция выполняется в интерфейсе Zabbix.
- Перейдите в:
Configuration → Hosts. - Если хост ранее не создавался, добавьте его по описанию «3. Добавление узла сети (хоста) сбора данных».
- Откройте хост, в который необходимо давить интеграцию, кликнув по его имени в списке доступных хостов раздела. Откройте вкладку «Templates».
- Справа от поля «Link new templates» нажмите кнопку «Select». Для выбора включите чекбокс напротив шаблона «INSPARK Params on Object». Завершите выбор нажатием кнопки «Select».
- Перейдите на вкладку Macros. Добавьте следующие поля в «Host macros»:
| Поле Macro | Описание | Пример поля Value |
|---|---|---|
{$INSPARK.API.URL} |
Адрес, порт службы REST API Inspark IoT | http:// 10.0.0.1:8080/sem-restservices |
{$INSPARK.OBJECT} |
ID контролируемого объекта Ispark IoT | 26 |
{$INSPARK.PASSWORD} |
Пароль учетной записи для доступа к данным через REST API Inspark IoT | DemoPassword |
{$INSPARK.USERNAME} |
Имя учетной записи для доступа к данным через REST API Inspark IoT | demo |
Примечание: список добавляемых «macros» приведен в описании шаблона (см. поле «Description»).
- Сохраните внесенные изменения нажатием кнопки «Update».
¶ 4.2. Период опроса и хранение исторических данных
Шаблон zbx_INSPARK_Params_Object имеет следующие параметры настроек:
- получение данных из Inspark IoT - один раз минуту;
- хранение сырых данных - 1 час;
- хранение истории полученных значений датчиков – 90 дней;
- хранение динамики изменений – 365 дней.
Изменение установленных значений выполняется корректировкой параметров шаблона:
- период получения данных: значение поля «Update interval» для Items «INSPARK:Get data»;
- период хранения истории данных и динамики изменения: значения полей «History storage period» и «Trend storage period» соответствующих прототипов критериев мониторинга (вкладка «Discovery rules» → «Item prototypes»).
¶ 4.3. Критерии мониторинга (Items)
В соответствии с правилами анализа данных шаблона и на основании массива полученной информации от Inspark IoT, автоматически формируется список критериев мониторинга объекта (вкладка Items). Проводится автоматическое разделение критериев по группам в зависимости от типа данных (тип данных мониторинга):
| Код данных | Единица измерения |
|---|---|
| code | код |
| degree | град |
| percent | % |
| power | кВт·час |
| other | все остальные измерения |
Для каждого измеряемого параметра объекта мониторинга Inspark IoT шаблона zbx_INSPARK_Params_Object формируется два контролируемых критерия (два Items для разных полей данных одного ID):
| Поле данных | Расшифровка |
|---|---|
| name | Название параметра в Inspark IoT |
| value | Значение параметра |
Имена критериев формируются по правилу:
Get <Код правила discovery> discovery: INSPARK:Get data: Sensor <Код данных> ID:#<ID объекта в Inspark IoT> <Поле данных>
Для использования инструментов поиска и фильтрации данных в Zabbix каждому критерию назначаются следующие теги:
| Tag | Значение |
|---|---|
| Application | INSPARK |
| Measure | <Код данных> |
| Sensor ID | ID объекта в Inspark IoT |
¶ 4.4. Контроль измерений. Триггеры (Trigeer)
Триггеры это логические правила, которые позволяют «оценивать» состояние получаемых данных и отражают текущее состояние системы. Для каждого измеряемого параметра объекта Inspark IoT правилами шаблона zbx_INSPARK_Params_Object добавляются следующие триггеры:
| Триггер | Тип события | Ручной сброс события | Вид измерения | Поле данных |
|---|---|---|---|---|
| Контроль изменения параметра | Information | Да | code, degree, percent, power, other | name |
| Отсутствие данных от датчика в течении 2-х минут | High | Нет | code, degree, percent, power, other | value |
| Контроль достоверности данных* | Warning | Да | code | value |
Триггер предназначен для датчиков с контролем достоверности данных. Значение «3» сигнализирует о корректности данных. По умолчанию триггер отключен.
Правило формирования имен триггеров:
Get <Код правила discovery> discovery: Sensor <Код данных> ID:#<ID объекта в Inspark IoT> <тип функции триггера> [<Поле данных>]
При необходимости добавление других триггеров контроля данных осуществляется администратором Zabbix непосредственно в конфигурацию хоста самостоятельно.
¶ 4.5. Графики (Graphs). Панели (Dashboard).
Графики служат для визуализации данных собранных по объекту мониторинга.
По результату анализа массива полученных данных из Inspark IoT правилами шаблона zbx_INSPARK_Params_Object добавляются графики соответствующие следующим критериям:
- автоматически сгенерированное имя критерия содержит код «value»;
- единицами измерений: «град», «%» и «кВт·час».
Правило формирования имен графиков:
<Тип графика> graph Sensor ID: <ID объекта в Inspark IoT> (<Код данных>) - <Имя датчика в Inspark IoT>
Эти же графики собираются на Dashboard хоста с разбиением по типу данных (без группировки).
Пример Dashboard:
¶ 5. Шаблон «Получения измеряемых метрик сенсоров»
(Template zbx_inspark_params_sensors_v1.yaml)
Шаблон позволяет автоматизировать процесс добавления списка объектов Inspark IoT типа измеряемый параметр в систему мониторинга Zabbix. Идентификация объектов мониторинга осуществляется по ID объектов в Inspark IoT. Требуемые ID сенсоров можно получить в интерфейсе Inspark IoT «Главная / Объект / … / Изм.Параметры». При добавлении шаблона к хосту в системе мониторинга Zabbix, осуществляется автоматическое формирование списка измеряемых параметров в раздел Items для списка датчиков, ID которых заданы через макрос {$INSPARK.IDS} хоста.
¶ 5.1. Добавление шаблона интеграции
Порядок добавления и настройки интеграции. Операция выполняется в интерфейсе Zabbix.
- Перейдите в:
Configuration → Hosts. - Если хост ранее не создавался, добавьте его по описанию «3. Добавление узла сети (хоста) сбора данных».
- Откройте хост, в который необходимо давить интеграцию, кликнув по его имени в списке доступных хостов раздела. Откройте вкладку «Templates».
- Справа от поля «Link new templates» нажмите кнопку «Select». Для выбора включите чекбокс напротив шаблона «INSPARK Params on Sensors». Завершите выбор нажатием кнопки «Select».
- Перейдите на вкладку Macros. Добавьте следующие поля в «Host macros»:
| Поле Macro | Описание | Пример поля Value |
|---|---|---|
{$INSPARK.API.URL} |
Адрес, порт службы REST API Inspark IoT | http:// 10.0.0.1:8080/sem-restservices |
{$INSPARK.IDS} |
Через запятую ID контролируемых сенсоров Ispark IoT; | 218,219,311,312 |
{$INSPARK.PASSWORD} |
Пароль учетной записи для доступа к данным через REST API Inspark IoT | DemoPassword |
{$INSPARK.USERNAME} |
Имя учетной записи для доступа к данным через REST API Inspark IoT | demo |
Примечание: список добавляемых «macros» приведен в описании шаблона (см. поле «Description»).
- Сохраните внесенные изменения нажатием кнопки «Update».
¶ 5.2. Период опроса и хранение исторических данных
Шаблон zbx_INSPARK_Params_Object имеет следующие параметры настроек:
- получение данных из Inspark IoT - один раз минуту;
- хранение сырых данных - 1 час;
- хранение истории полученных значений датчиков – 90 дней;
- хранение динамики изменений – 365 дней.
Изменение установленных значений выполняется корректировкой параметров шаблона:
- период получения данных: значение поля «Update interval» для Items «INSPARK:Get data»;
- период хранения истории данных и динамики изменения: значения полей «History storage period» и «Trend storage period» соответствующих прототипов критериев мониторинга (вкладка «Discovery rules» → «Item prototypes»).
¶ 5.3. Критерии мониторинга (Items)
В соответствии с правилами анализа данных шаблона и на основании списка указанных ID датчиков Inspark IoT, автоматически формируется список критериев мониторинга объекта (вкладка Items). Проводится автоматическое разделение критериев по группам в зависимости от типа данных (тип данных мониторинга):
| Код данных | Единица измерения |
|---|---|
| code | код |
| degree | град |
| percent | % |
| power | кВт·час |
| other | все остальные измерения |
Для каждого измеряемого параметра объекта мониторинга Inspark IoT правилами шаблона zbx_INSPARK_Params_Sensors формируется три контролируемых критерия (три Items для разных полей данных одного ID):
| Поле данных | Расшифровка |
|---|---|
| deviceState | Статус устройства |
| name | Название параметра в Inspark IoT |
| value | Значение параметра |
Имена критериев формируются по правилу:
Get <Код правила discovery> discovery: INSPARK:Get data: Sensor <Код данных> ID:#<ID датчика в Inspark IoT> <Поле данных>
Для использования инструментов поиска и фильтрации данных в Zabbix каждому критерию назначаются следующие теги:
| Tag | Значение |
|---|---|
| Application | INSPARK |
| Measure | <Код данных> |
| Sensor ID | ID объекта в Inspark IoT |
¶ 5.4. Графики (Graphs). Панели (Dashboard)
Графики служат для визуализации данных собранных по объекту мониторинга.
По результату анализа массива полученных данных из Inspark IoT правилами шаблона zbx_INSPARK_Params_Sensors добавляются графики соответствующие следующим критериям:
- автоматически сгенерированное имя критерия содержит код «value»;
- единицами измерений: «град», «%» и «кВт·час».
Правило формирования имен графиков:
<Тип графика> graph Sensor ID: <ID объекта в Inspark IoT> (<Код данных>) - <Имя датчика в Inspark IoT>
Эти же графики собираются на Dashboard хоста с разбиением по типу данных (без группировки).
Пример Dashboard:
