Monitorix Gemini-Frontend

Gemini-page with Monitorix ascii-graphs in braille.

• System load average and usage (System load, Memory allocation, Active processes, Entropy, Uptime)
• Filesystem usage and I/O activity (Filesystem usage, Disk I/O activity, Inode usage, Time spent in I/O activity)
• Network traffic and usage (Traffic, Packets Errors)
• Icecast (Listeners, Bitrate)

Install

Requirements:

• Monitorix - installed and started system service
• rrdtool - python package to provide access to *.rrd database files
• brasciichart - python package to ascii-graph

Installing rrdtool python-package can require developer packages: python3.x-dev, librrd-dev.

$ sudo apt install python3.9-dev librrd-dev

$ pip install GmMonitorix

After GmMonitorix successfully installed, remove dev-packages if not required:

$ sudo apt remove python3.9-dev librrd-dev

The Gemini-server account should have write-access in the work directory. To protect monitorix page with user certificate, place .admins file with user's certificate fingerprints into this work directory.

GmCapsule

For GmCapsule server add to your config-file a section with CGI-settings.

[cgi.monitorix]
# monitoring gemini-page url-path
path = /monitorix/*

cwd = /writable/work/dir/

# path to a Python-interpreter with rrdtool, brasciichart, GmMonitorix
command = /path/to/python3 -m GmMonitorix

The monitoring gemini-page will be accessible by gemini://<hostname>/monitorix/cgi URL.

Links

• Gemini Protocol
• Project Gemini FAQ
• Monitorix
• GmCapsule (codeberg.org)
• GmCapsule User manual :: Configuration

TODO

• all metrics
• support net traffic bit/s
• support FreeBSD, OpenBSD, NetBSD total memory bytes
• support uptime units: minutes, hours
• support OpenBSD, NetBSD with m_mused, m_macti only

Change log

v0.1.2

• Add Icecast (Listeners, Bitrate)

v0.1.1

• Add Filesystem Usage (Usage, Disk I/O, Inode, Time spent in I/O)
• Use rigid and limits from config

v0.1.0

Initial release