https://github.com/markwinter/grovemonitoring
Grove Room Sensor Monitoring visualised in Grafana
https://github.com/markwinter/grovemonitoring
Last synced: 11 months ago
JSON representation
Grove Room Sensor Monitoring visualised in Grafana
- Host: GitHub
- URL: https://github.com/markwinter/grovemonitoring
- Owner: markwinter
- License: mit
- Created: 2021-01-26T14:20:08.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-01-27T03:39:47.000Z (over 5 years ago)
- Last Synced: 2025-02-10T14:43:16.711Z (over 1 year ago)
- Language: Python
- Size: 19.5 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Grove Monitoring
Python3 server that reads Grove Room Sensors and exports the values for Prometheus scraping
The sensors are read every 5 seconds

### Required Hardware
- Raspberry PI. Tested on Raspberry Pi 4 Model B
- [Grove Base Hat](https://wiki.seeedstudio.com/Grove_Base_Hat_for_Raspberry_Pi/)
- [Grove Sunlight Sensor](https://wiki.seeedstudio.com/Grove-Sunlight_Sensor/)
- [Grove AHT20 Temperature & Humidity Sensor](https://wiki.seeedstudio.com/Grove-AHT20-I2C-Industrial-Grade-Temperature&Humidity-Sensor/)
- [Grove Laser PM2.5 Dust Sensor](https://wiki.seeedstudio.com/Grove-Laser_PM2.5_Sensor-HM3301/)
- [Grove Air Quality Sensor v1.3](https://wiki.seeedstudio.com/Grove-Air_Quality_Sensor_v1.3/)
### Required Software
You should have the following software installed already.
- Grafana
- Prometheus
### Installation
- Edit the `User` field in `systemd/grovemonitoring.service` to your linux account
- Edit the path to `app.py` in `ExecStart`
- Install the systemd service to /etc/systemd/system/grovemonitoring.service
```SHELL
$ sudo cp systemd/grovemonitoring.service /etc/systemd/system/
$ sudo systemctl daemon-reload
$ sudo systemctl start grovemonitoring
$ sudo systemctl status grovemonitoring
$ sudo systemctl enable grovemonitoring # Enable on boot
```
- Check the exported metrics at `localhost:8000`
- Import the GroveMonitoring dashboard into your Grafana instance `13779`
https://grafana.com/grafana/dashboards/13779