Canary is a simple service to monitor a few stats about Minecraft servers. Specifically, it keeps track of whether the server is down or up and how long it has been in that state as well as the MOTD and number of players.
First you'll need to grab the required
pip install -r requirements.txt
Right now, the simplest way to get Canary running is to run
and set up cron jobs to update the data for each server every so often by using
curl (this ensures that the "how long" data is mostly accurate):
curl http://localhost:5000/s/<server> > /dev/null 2>&1
Then you can just point your browser at http://localhost:5000/ and punch in the server to see the latest results (this will also trigger an update if there hasn't been one recently).
I recommend the use of something like gunicorn for running the application in a production environment.
settings.py file for more tweaks. To use custom settings, create a new file, put the new settings in it, and set the environment variable
CANARY_SETTINGS to the path of the new file before running Canary.
Why not? It's useful to not have to open the Minecraft client to check on a server, plus it's nice to see how long the server has been down/up.
The name "canary" comes from the original status monitor--the canary in the coal mine.
Created by Nick Aldwin.