mirror of
https://github.com/munin-monitoring/contrib.git
synced 2025-07-29 12:25:02 +00:00
Lots of changes: * Fix the README * Add a makefile to fetch bootstrap, lazyload, jquery, the munin logo, and the munin favicon * Mostly re-write dynazoom. It works very much like the stock one now, with a few extra quick buttons, and of course the bootstrap styling * Remove all minified versions of scripts / css - The includes are minimal, it was not much of cost savings * Add sample images * Rename template to "muncollapse"
133 lines
4 KiB
Markdown
133 lines
4 KiB
Markdown
# MunCollapse
|
|
|
|
Alternative Munin 2.x templates based on Twitter Bootstrap using collapsibles.
|
|
|
|
Based on some of the work of "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="sample-image/sample-home.png"><img src="sample-image/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/) - 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:
|
|
<a href="sample-image/sample-group.png"><img src="sample-image/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="sample-image/sample-node.png"><img src="sample-image/sample-node.png" style="max-width: 1229px; display:block; margin-left: auto; margin-right: auto; width: 75%" /></a>
|
|
|
|
|
|
#### Zoom feature:
|
|
<a href="sample-image/sample-zoom.png"><img src="sample-image/sample-zoom.png" style="max-width: 1229px; display:block; margin-left: auto; margin-right: auto; width: 75%" /></a>
|
|
|
|
|
|
---
|
|
|
|
## 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.
|