openaps-monitor

Status dashboard for your openaps project

This README is a work-in-progress

Installing

Check out the source using git:

$ git clone git@github.com:loudnate/openaps-monitor.git

Install the required python packages:

$ cd openaps-monitor
$ pip install -r requirements.txt

Initial setup

The first time you run the server, it will need to cache some third-party assets, so make sure your machine is connected to the internet.

The server takes one argument, which is the path to your openaps project:

$ python monitor.py ../myopenaps

From a web browser, check that the server is running by entering the hostname of your machine in the address bar, followed by the port number.

• http://myraspberrypi.local:5000

Customizing the monitor to graph report data

If you'd like to graph your report data, you can set the path names of your reports in the Settings class in the 'settings.py' file.

Running the monitor server on machine startup

There are multiple ways to run the server automatically on startup. Advanced users might look into supervisord.

Here's a script to launch the server in a screen session, which you can access from a shell at various times without having to keep shell window open.

start-monitor.sh

cd /home/pi/src/openaps-monitor
screen -d -A -S monitor -m python monitor.py ../myopenaps
cd -

You can run that script using cron's @reboot directive, ignoring the output if you don't want to see an email about it.

crontab -e

@reboot              /home/pi/start-monitor.sh > /dev/null