4.0 KiB
MunCollapse
Alternative Munin 2.x templates based on Twitter Bootstrap using collapsibles.
Based on some of the work of "Munstrap" by Jonny McCullagh, munin-monitoring/contrib repo.
Overview Sample Image
Semi-Live Demo - For the purposes of this demo only, the data is static and the zoom functionality is disabled.
Installation
1. Clone the munin-monitoring/contrib repo to a temporary location:
$ cd /opt
$ git clone https://github.com/munin-monitoring/contrib.git
2. Fetch the template libraries
$ cd /opt/contrib/templates/muncollapse/
$ make
3. Place the template in an appropriate safe place
Ubuntu shown - other distros may prefer /usr/local/share/munin/...
$ mkdir /usr/share/munin/template
$ mkdir /usr/share/munin/template/muncollapse
NOTE: If this step fails, your munin installation may use /usr/local/share/munin/...
instead!
$ cp -r /opt/contrib/templates/muncollapse/templates /usr/share/munin/template/muncollapse/
$ cp -r /opt/contrib/templates/muncollapse/static /usr/share/munin/template/muncollapse/
4. Edit your munin.conf
file.
Typically located at /etc/munin.conf
FIND AND CHANGE: (near the top of the file)
# Where to look for the HTML templates
#
#tmpldir /etc/munin/templates
# Where to look for the static www files
#
#staticdir /etc/munin/static
TO:
# Where to look for the HTML templates
#
tmpldir /usr/share/munin/template/muncollapse/templates
# Where to look for the static www files
#
staticdir /usr/share/munin/template/muncollapse/static
5. [Optional / Recommended] Clean out the old generated files.
This isn't really required, but there will likely be orphaned files. The location of these files can be found in your munin.conf
file, with the htmldir
directive.
NOTE: Ubuntu shown, other distributions may be in /var/www/munin/
$ rm -rf /var/cache/munin/www/*
6. Wait Patiently
munin-update
will regenerate the files the next time it runs. By default, this is on the :05 minute tick for most installations. If you do not have new files within 10 minutes, be sure to check munin-update.log
and find out what went wrong.
Revert to Official Munin Template
1. Edit your munin.conf
file.
Typically located at /etc/munin.conf
FIND AND CHANGE: (near the top of the file - comment these lines out!)
Where to look for the HTML templates
#tmpldir /usr/share/munin/template/muncollapse/templates
Where to look for the static www files
#staticdir /usr/share/munin/template/muncollapse/static
2. [Optional / Recommended] Clean up
Remove the files from step #1 & #3 above, and repeat step #5 & #6.
Samples
View of a group:
View of a specific node:
Zoom feature:
Munin Compatibility
a/n: I am unsure of the compatibility with Munin 3. Most things will work from what I've read, but the navigation may be slightly funky.
Browser Compatibility
For this template set, Internet Explorer support has been dropped for the dynamic zoom functions. Everything else should work across all browsers.