Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jtsage/muncollapse

Spiritual Successor to the munstrap Munin template (using bootstrap 4, fixing some things I didn't like)
https://github.com/jtsage/muncollapse

bootstrap4 munin munin-graphs munin-monitoring munin-plugins

Last synced: 17 days ago
JSON representation

Spiritual Successor to the munstrap Munin template (using bootstrap 4, fixing some things I didn't like)

Awesome Lists containing this project

README 

        
# 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




[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:




#### 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.