Zabbix: различия между версиями

Материал из Wiren Board
(не показано 16 промежуточных версий 4 участников)
Строка 1: Строка 1:
== Подготовка ==
<languages/>
<translate>
<!--T:1-->
См. также:
Нативный мост в Zabbix: https://github.com/contactless/wb-mqtt-zabbix
Пакеты в разделе Releases.


== Подготовка == <!--T:2-->
<!--T:3-->
Нужно поставить zabbix-agent:
Нужно поставить zabbix-agent:


<syntaxhighlight lang="bash">
<!--T:4-->
apt update && apt install zabbix-agent -y
<pre>
</syntaxhighlight>
apt-get install zabbix-agent
</pre>


В нашем репозитории только первая версия агента, но вы можете установить вторую версию на сервер с Zabbix (или на контроллер) и подключиться к MQTT контроллера оттуда.
== Настройка Zabbix Agent == <!--T:5-->


== Настройка Zabbix Agent ==
<!--T:6-->
Для получения значений переменных в Zabbix используется чтение retained-значений каналов.


Получение значений переменных в Zabbix происходит через чтение retained-значений каналов.
<!--T:7-->
Для настройки zabbix-agent нужно создать файл
<pre>
zabbix-mqtt.conf
</pre>


Для работы zabbix-агента ему нужно дать расширенные права доступа. Поэтому потребуется установить <code>sudo</code>:
<!--T:8-->
<syntaxhighlight lang="bash">
в директории
apt install sudo -y
<pre>
</syntaxhighlight>
/etc/zabbix/zabbix_agentd.d/
</pre>


Предоставить нужные права пользователю zabbix можно командой:
<!--T:9-->
<syntaxhighlight lang="bash">
со следующим содержимым:
echo 'zabbix ALL=(ALL) NOPASSWD: /usr/bin/mosquitto_sub' > /etc/sudoers.d/zabbix-mqtt
</syntaxhighlight>
 
Далее необходимо создать файл <code>zabbix-mqtt.conf</code> в директории <code>/etc/zabbix/zabbix_agentd.conf.d/</code> и записать в него строку:


<!--T:10-->
<pre>
<pre>
UserParameter=mqtt.value[*], sudo mosquitto_sub -t '$1' -C 1
UserParameter=mqtt.value[*],mosquitto_sub -t '$1' -C 1
</pre>
</pre>


Это можно сделать одной командой:
== Использование == <!--T:11-->
<syntaxhighlight lang="bash">
echo "UserParameter=mqtt.value[*], sudo mosquitto_sub -t '\$1' -C 1" > /etc/zabbix/zabbix_agentd.conf.d/zabbix-mqtt.conf
</syntaxhighlight>
 
== Использование ==


<!--T:12-->
Обращение к каналам в Zabbix происходит следующим образом:
Обращение к каналам в Zabbix происходит следующим образом:
<pre>
<pre>
Строка 41: Строка 49:
</pre>
</pre>


<!--T:13-->
где topic - топик соответствущего канала в [[Special:MyLanguage/MQTT|MQTT]]
где topic - топик соответствущего канала в [[Special:MyLanguage/MQTT|MQTT]]


<!--T:14-->
например:
например:


<!--T:15-->
<pre>
<pre>
mqtt.value[/devices/sht1x/controls/humidity]
mqtt.value[/devices/sht1x/controls/humidity]
mqtt.value[/devices/sht1x/controls/temperature]
mqtt.value[/devices/sht1x/controls/temperature]
</pre>
</pre>
 
</translate>
Пример теста агента, запускать на контроллере:
<syntaxhighlight lang="bash">
zabbix_agentd -t mqtt.value[/devices/buzzer/controls/frequency]
</syntaxhighlight>
 
==Полезные ссылки==
* [https://github.com/contactless/wb-mqtt-zabbix Репозиторий с устаревшим нативным мостом в Zabbix]. Пакеты в разделе [https://github.com/wirenboard/wb-mqtt-zabbix/releases Releases].
* Статья на Хабре «[https://habr.com/ru/post/525852/ Zabbix + Wirenboard: мониторинг производства]» — подробное описание создания системы с Wiren Board и Zabbix. В статье используется плагин, написанный пользователем — [https://github.com/v-zhuravlev/zbx_mqtt zbx_mqtt]
* [https://support.wirenboard.com/t/zabbix-agent-dlya-kontrollera/18376 Пакет с агентом v.6.4.10]

Версия 16:19, 24 мая 2020

Другие языки:

См. также: Нативный мост в Zabbix: https://github.com/contactless/wb-mqtt-zabbix Пакеты в разделе Releases.

Подготовка

Нужно поставить zabbix-agent:

apt-get install zabbix-agent

Настройка Zabbix Agent

Для получения значений переменных в Zabbix используется чтение retained-значений каналов.

Для настройки zabbix-agent нужно создать файл

zabbix-mqtt.conf

в директории

/etc/zabbix/zabbix_agentd.d/

со следующим содержимым:

UserParameter=mqtt.value[*],mosquitto_sub -t '$1' -C 1

Использование

Обращение к каналам в Zabbix происходит следующим образом:

mqtt.value[topic]

где topic - топик соответствущего канала в MQTT

например:

mqtt.value[/devices/sht1x/controls/humidity]
mqtt.value[/devices/sht1x/controls/temperature]