mirror of https://github.com/munin-monitoring/contrib.git synced 2025-08-03 14:48:22 +00:00

JTSage bc2dc914b3 Add "munstrap4" template.

This template is based on the original munstrap template, updated
to use bootstrap4 and fixing some of the navigation issues the
author had with the original project.

Key Features:
 * Most pages use lazy-loaded images to cut down network usage.
 * Graph Catergory per node is directly linkable
 * Modal based graph zoom (requires working munin-graph-cgi
 * JavaScript implemented search feature to quickly jump to the desired display.

2020-04-09 14:13:04 -04:00

Munstrap4

Alternative Munin 2.x templates based on Twitter Bootstrap 4.

Based on "Munstrap" by Jonny McCullagh, munin-monitoring/contrib repo.

Overview Sample Image

Semi-Live Demo

Zoom functionality for this demo has been disabled, and the data will never update, but it's a decent visual reference.

Installation

1. Clone the munin-monitoring/contrib repo to a temporary location:

$ cd /opt
$ git clone https://github.com/munin-monitoring/contrib.git

2. 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/munstrap4

NOTE: If this step fails, your munin installation may use /usr/local/share/munin/... instead!

$ cp -r /opt/contrib/templates/munstrap4/templates /usr/share/munin/template/munstrap4/
$ cp -r /opt/contrib/templates/munstrap4/static /usr/share/munin/template/munstrap4/

3. 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/munstrap4/templates

# Where to look for the static www files
#
staticdir /usr/share/munin/template/munstrap4/static

4. [Optional / Recommended] Clean out the old generated files.

This isn't really required, and is totally not nessesary if you are using munin-httpd. 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/*

5. 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!)

2. [Optional / Recommended] Clean up

Remove the files from step #1 & #2 above, and repeat step #4 & #5.

Samples

View of a group:

View of a specific node:

Zoom feature:

Compatibility

a/n: I am unsure of the compatibility with the next major version of munin. Most things will work from what I've read, but the navigation may be slightly funky.

3.7 KiB Raw Blame History