This module integrates Munin into Icinga Web 2.
Munin and this Icinga Web 2 module are licensed under the terms of the GNU General Public License Version 2, you will find a copy of this license in the LICENSE file included in the source package.
The module adopts the same license as Munin, having copied some CSS from Munin.
This module glues Munin and Icinga Web 2 together. Both of them are required to be installed and configured:
Extract this module to your Icinga Web 2 modules directory in the munin
directory.
mkdir -p /usr/local/share/icingaweb2/modules
cd /usr/local/share/icingaweb2/modules
git clone https://github.com/sebastic/icingaweb2-module-munin.git munin
Ensure that the module_path
in the global
section of the Icinga Web 2 config.ini
includes the path for custom modules, e.g.:
module_path = "/usr/share/icingaweb2/modules:/usr/local/share/icingaweb2/modules"
Enable the module in the Icinga Web 2 frontend in Configuration -> Modules -> munin -> State
.
You can also enable the module by using the icingacli
command:
icingacli module enable munin
The base URL for Munin (e.g. /munin
) must be accessible on the webserver.
When using graph_strategy cgi
the base URL for munin-cgi-graph
(e.g. /munin-cgi/munin-cgi-graph
) must also be accessible.
Install the config.ini
file in the module configuration directory.
cd /usr/local/share/icingaweb2/modules/munin
mkdir -p /etc/icingaweb2/modules/munin
cp etc/config.ini /etc/icingaweb2/modules/munin/
Adjust the content of the configuration file to match your Munin setup.
When not using cron to generate the graphs, make sure to change graph_strategy
to cgi
.
In addition to the standard pages provided by Munin, this module supports adding custom pages.
Custom pages are configured in a JSON configuration file.
Have a look at icingaweb2-module-munin_custom-pages.json for an example.
To enable custom pages, add the custom_pages
section to module config.ini
and specify the path to the configuration file.
[custom_pages]
config_file = "/usr/local/etc/icingaweb2-module-munin_custom-pages.json"