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.