I designed this to monitor my Workshop using the Raspberry PI that also serves as an octoprint server. This lets me see my printroom conditions at a glance via an embedded web interface and also on a small OLED display.
SBCeye records and displays the CPU temperature, load and memory usage of the SBC itself, plus some other system basics. It can also monitor ping times and status for network targets you specify (eg your router, or a wifi enabled controller, etc.)
Readings happen every 10 seconds and are held in a database, it has a built in graph generator and you can view graphs for arbitrary time periods. This tool is designed to provide a 'fine grained' low-level logging for machines that work as controllers, as opposed to the slower but more sophisticated and comprehensive system health logging supplied by Munin and similar.
This can be run on any system that supports the Python3 psutil package and the rrdb tool. Currently tested on Debian, Fedora and FreeBSD.
You can use an optional I2C BME280 environmental sensor to also record the room temperature, pressure and humidity readings.
You can display the current status on a small OLED I2C display sharing the same bus as the BME280, this animates through the current status and has a night/screensaver feature.
It also has the ability to optionally monitor and log specified GPIO pins as they are toggled by other programs (eg printer power control pins controlled by Octoprint, etc.)
I have written this to be very low impact on the host; database readings are cached and disk writes only happen every five minutes in order to minimize impact on the SD card. There is in-built housekeeping to do database backups, online dumps and log rotation.
Bonus! Control a light connected to a GPIO pin via a button and/or URL, this is a convenience feature I added for myself so I can easily toggle my workbench lamps when in the room, or remotely via the web when viewing my webcams.
Written in Python as a learning exercise, it draws heavily on RRDtool, RPI.GPIO, psutil, the default python http.server and CircuitPython for interfacing with sensor and screen.
On a PI3b with some network targets, a BME280 sensor and/or some GPIO pins to monitor
Add a 128x64 OLED display
Log GPIO actions etc..
Embeddable Panels and Standalone Graphs
- Python3.7+, pip and virtualenv
The install guide covers installing these, and the rest of the requirements in a way that wont conflict with other python tools and versions on your system:
- Schedule
- python RRDtool
- psutil For sensor:
- CircuitPython BME280 For display:
- CircuitPython SSD_1306
- image
- Liberation Fonts
This is covered in detail here: docs/INSTALL.md
- Install is done via a python virtual environment to avoid any conflicts with other Python installs (such as OctoPrint)
Copy the default.ini file in the repo to config.ini and edit..
- All the useful options are commented in the file
- Restart SBCEye to apply any changes
I need to flesh this out in a separate document.
In brief: Customizing should be relatively easy, add a data source and commands to gather it in SBCEye.py (see how this is done for the CPU temperature, etc); then add it to the graph structures in robin.py and the sensorlist in httpserver.py. Customizing the screens for an OLED display can be done in animate.py
The sensor, display and GPIO control is all optional. The unit itself can only control a single pin, but it can monitor and log multiple pins if you are also using GPIO for controlling other apparatus (eg 3d printer power supplies)
- I2C goes to the 0.96' OLED screen and BME280 Sensor module
- GPIO outputs controlling lights etc; opto-isolated relay boards are your friend here.
- Button goes to a spare GPIO with a pull-down resistor
I want to add an extensible alerting function.. see #15
https://circuitpython.readthedocs.io/en/latest/shared-bindings/index.html https://circuitpython.readthedocs.io/projects/framebuf/en/latest/api.html https://circuitpython.readthedocs.io/projects/bme280/en/latest/api.html