Monitoring Temperature, Humidity, Pressure and so on with Zabbix + Ruuvitag

By Antti Hurme 02/07/2023 No Comments 4 Min Read

I’ve been using Ruuvitags to measure different places around my house some time, and storing the data to my Zabbix installation. The GitHub repository below contains all the necessary files, as well as rudimentary install instructions.

You need to have a device that can run Python 3.7.x, has a compatible Bluetooth device and has the required Zabbix binaries. In addition you need to follow the ruuvitag-sensor repository guide for the prerequisits; ttu/ruuvitag-sensor: Python package for communicating with RuuviTag BLE Sensor and for decoding sensor data from broadcasted data (


BlueZ works only on Linux. When using BlueZ, Windows and macOS support is only for testing with hard-coded data and for data decoding.

BlueZ tools require superuser rights.

$ sudo apt-get install bluez bluez-hcidump

ruuvitag-sensor package uses internally hciconfighcitool and hcidump. These tools are deprecated. In case tools are missing, an older version of BlueZ is required (Issue)

Python Modules Installation

Install the latest released version$ python -m pip install ruuvitag-sensor

Zabbix Scripts and Templates

  1. Install zabbix-agent or zabbix-agent2 and zabbix-sender
  2. Import Zabbix Template
  3. Clone git repository to /home/ruuvi/Ruuvitag and add u+x to the python files. Files in my example owned by the user ruuvi. (Zimeon-/Ruuvitag_Zabbix-RaspberryPi: Ruuvitag Sensor datacollection to Zabbix with RaspberryPi Debian (
  4. Configure your ruuvitags to the ruuvitags.json file (Bluetooth Mac, Zabbix Itemkey (Unique, without spaces or special characters), Displayname)

To find your Ruuvitags, you can run the python file manually. Example output below:

ruuvi@ruuvi:~/Ruuvitag $ python
Finding RuuviTags. Stop with Ctrl+C.
Start receiving broadcasts (device hci0)
FYI: Calling a process with sudo: hciconfig hci0 reset
FYI: Spawning process with sudo: hcitool -i hci0 lescan2 --duplicates --passive
FYI: Spawning process with sudo: hcidump -i hci0 --raw
{'data_format': 5, 'humidity': 45.3, 'temperature': 24.38, 'pressure': 980.96, 'acceleration': 1016.8343031192447, 'acceleration_x': -36, 'acceleration_y': -20, 'acceleration_z': 1016, 'tx_power': 4, 'battery': 3101, 'movement_counter': 70, 'measurement_sequence_number': 27397, 'mac': 'aabbcc443355'}
{'data_format': 5, 'humidity': 51.04, 'temperature': 23.23, 'pressure': 981.06, 'acceleration': 1053.7703734685276, 'acceleration_x': 52, 'acceleration_y': -32, 'acceleration_z': 1052, 'tx_power': 4, 'battery': 3083, 'movement_counter': 29, 'measurement_sequence_number': 27431, 'mac': 'aabbcc662244'}
^CStop receiving broadcasts
  1. Add the following user parameters to your Zabbix agent configuration file. Remember to restart the Zabbix agent!
UserParameter=ruuvitag.get,python /home/ruuvi/Ruuvitag/,python /home/ruuvi/Ruuvitag/
  1. Add the following cron to the user ruuvi with #crontab -e
*/1 * * * * python /etc/zabbix/scripts/ruuvitag/
  1. Verify functionality with Zabbix.
You can run the ruuvitag discovery manually in Zabbix frontend. This should create the neccessary items based on your ruuvitags.json file defined earlier.

Note: These scripts assume that they are located in “/home/ruuvi/Ruuvitag/” directory. If you choose to save them somewhere else, remember to change these hardcoded paths.

Create dashboards to your liking, and you can view the items and data in the hosts latest data.

Source for the project: Zimeon-/Ruuvitag_Zabbix-RaspberryPi: Ruuvitag Sensor datacollection to Zabbix with RaspberryPi Debian (

Written By

Who am I? | Linkedin

View All Articles
Leave a Reply

Leave a Reply

Your email address will not be published. Required fields are marked *

The reCAPTCHA verification period has expired. Please reload the page.

This site uses Akismet to reduce spam. Learn how your comment data is processed.