Querx and Zabbix
The Querx network-thermometers can be integrated with the open-source network-monitoring system Zabbix with the help of a provided template. The template defines items for temperature and humidity, a graph that displays both values together and the following triggers:
▪ Querx can not be reached
▪ Upper temperature threshold transgressed
▪ Lower temperature threshold transgressed
▪ Upper humidity threshold transgressed
▪ Lower humidity threshold transgressed
The predefined values correspond to the values suggested in this tutorial and can be adjusted to your specific needs. Various options for the display of alerts are available. In this tutorial we will be drawing on the triggers available in Zabbix.
For the sake of this tutorial, we chose to use Querx TH as the sensor we will install.
Installing the Template
Download the Zabbix template for Querx TH from the Zabbix community Wiki. Then open Zabbix as the admin, navigate to the menu point Configuration (1) and select Templates (2).
Now import the downloaded template by clicking Import in the top right corner.
Select the downloaded file and then click Import.
As long as no unexpected problems occur, Zabbix will confirm that the template has been imported successfully.
Creating a Host for Querx and Adjusting the Items
Create a host for Querx TH by navigating to the menu Configuration (1), selecting the section Hosts (2) and clicking Create host (3) in the top right corner.
A number of basic parameters need to be entered on the following page: A Host name for Zabbix (1), a Visible hostname for the system (2) and a host Group in which Querx is to be listed (3). If no suitable host group exists yet, you can create one. Since Querx and Zabbix communicate via SNMP, you will need to add a new SNMP interface and enter the IP address (4) at which Querx can be reached on the network. Then click Template (5), in order to assign the new host to the template that was imported in the previous step.
Click Link new template (1) to assign “Template Querx TH” (2) to the host. Then click Add (3) and finally, Save (4).
Checking the Host Settings
Now we need to make sure that the host has been successfully set up. Click the entry Latest Data in the menu Monitoring. Three items should now be displayed below the specified host name: System Name, Temperature and Humidity. This section lets you know when the respective items were last queried and what the returned value was. The default configuration updates the values every 30 seconds. If no data is visible, wait for this time period.
You may want to change the labels for the values or the rate at which the values are updated. Since these are already specified in the template, they will also need to be adjusted there. When accessing the items via the host configuration, the respective input fields can not be edited.
Navigate to the Configuration menu (1) and select the item Templates (2). Then click Items (3) under the entry Template Querx TH.
Here, the various items can be selected and edited. The above image shows an exemplary configuration for the temperature item with the SNMP OID 18.104.22.168.4.1.3422.214.171.124.126.96.36.199, the SNMP community public and an update interval of 30 seconds.
The most important SNMP OIDs for Querx TH
Calculated dew point
The MIB for Querx TH can be downloaded from the device itself at http:///egnitephysensor.mib
Please ensure that the temperature unit that is selected here is the same as the unit you have configured on Querx TH. You should also note that the temperature sensor, unlike the humidity sensor, employs the Custom Multiplier 0.1. This is used to divide the transferred value by 10. Querx multiplies the temperature values by 10 internally, in order to avoid floating point operations.