- 1 Installing Munin
- 2 Installing apache and php
- 3 Installing Munin
- 4 Testing Your Installation
What is Munin?
"Munin the monitoring tool surveys all your computers and remembers what it saw. It presents all the information in graphs through a web interface. Its emphasis is on plug and play capabilities. After completing a installation a high number of monitoring plugins will be playing with no more effort.
Using Munin you can easily monitor the performance of your computers, networks, SANs, applications, weather measurements and whatever comes to mind. It makes it easy to determine "what's different today" when a performance problem crops up. It makes it easy to see how you're doing capacity-wise on any resources.
Munin uses the excellent RRDTool (written by Tobi Oetiker) and the framework is written in Perl, while plugins may be written in any language. Munin has a master/node architecture in which the master connects to all the nodes at regular intervals and asks them for data. It then stores the data in RRD files, and (if needed) updates the graphs. One of the main goals has been ease of creating new plugins (graphs). "
Munin allows you to make pretty graphs about a systems statistics. You like pretty graphs, right?
The following guide sets up a munin under a directory beneath the html root.
If anyone would like to add a vhost setup guide please feel free to add it.
The html root is located under /srv/http. This directory may not be created by default, so create it if not.
#mkdir -p /srv/http
apache also creates (or uses) the user account and group of http:http.
#chown http:http /srv/http
All of these settings can be changed in the file
Munin relies is built using a client-server model. The client is munin-node, and the server is munin (refered to "munin-master" in all documentation). You MUST have munin-node and munin-master installed for this installation to work.
You will only need to install munin-master on a single machine. But munin-node will need to be installed on all machines you wish to monitor. This page will focus on a single machine installation. Further documentation may be found on the munin documentation wiki.
Installing apache and php
Install PHP php-apache and apache
#pacman -S apache php php-apache
Add an entry to your rc.conf
DAEMONS=(syslog-ng network netfs crond httpd)
Edit your /etc/hosts.allow (by adding the following line)
Start your webserver (sanity check)
Create a test document
#echo "Testing httpd" > /srv/http/index.html
Open a web browser to http://127.0.0.1/, and you should see the test document.
If it didn't work try (and check again):
chown -R http:http /var/run/httpd/
Stop the webserver
I left my httpd.conf alone, and munin is running. This probably isn't too secure. Maybe someone can update this section with a secure configuration.
Installing via yaourt
Currently there's a munin package in the AUR, and a munin-node package in extra, so ... yaourt is a great choice.
$yaourt -S munin munin-node
Now go check your /srv/http/ there should be a munin directory.
Run the following to have munin update every 5 minutes:
#crontab /etc/munin/munin-cron-entry -u munin
Add munin-node your rc.conf
Add an entry to your rc.conf
DAEMONS=(syslog-ng network netfs crond httpd munin-node)
Testing Your Installation
Believe it or not, you're almost done!
Start Your Services
#/etc/rc.d/httpd start #/etc/rc.d/munin-node start
Test the Web Page
Point your browser to:
You should see munin!
A Note About Update Frequency
It might take a while for the graphs to have data. So be patient. Wait about 30 mins to an hour.