mirror of
https://github.com/munin-monitoring/contrib.git
synced 2025-08-13 01:05:15 +00:00
bc2dc914b3
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.
114 lines
No EOL
3.7 KiB
Markdown
114 lines
No EOL
3.7 KiB
Markdown
# Munstrap4
|
|
|
|
Alternative Munin 2.x templates based on Twitter Bootstrap 4.
|
|
|
|
Based on "Munstrap" by [Jonny McCullagh](https://github.com/jonnymccullagh), [munin-monitoring/contrib](https://github.com/munin-monitoring/contrib/tree/master/templates/munstrap) repo.
|
|
|
|
#### Overview Sample Image
|
|
<a href="https://jtsage.dev/munstrap4/sample-home.png"><img src="https://jtsage.dev/munstrap4/sample-home.png" style="max-width: 1229px; display:block; margin-left: auto; margin-right: auto; width: 75%" /></a>
|
|
|
|
|
|
#### [Semi-Live Demo](https://jtsage.dev/munin-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:
|
|
<a href="https://jtsage.dev/munstrap4/sample-group.png"><img src="https://jtsage.dev/munstrap4/sample-group.png" style="max-width: 1229px; display:block; margin-left: auto; margin-right: auto; width: 75%" /></a>
|
|
|
|
#### View of a specific node:
|
|
<a href="https://jtsage.dev/munstrap4/sample-node.png"><img src="https://jtsage.dev/munstrap4/sample-node.png" style="max-width: 1229px; display:block; margin-left: auto; margin-right: auto; width: 75%" /></a>
|
|
|
|
|
|
#### Zoom feature:
|
|
<a href="https://jtsage.dev/munstrap4/sample-zoom.png"><img src="https://jtsage.dev/munstrap4/sample-zoom.png" style="max-width: 1229px; display:block; margin-left: auto; margin-right: auto; width: 75%" /></a>
|
|
|
|
|
|
---
|
|
|
|
## 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. |