Anderes Webverzeichnis¶

Munin legt seine Daten für den Webserver in /var/www/munin/ ab. Sollte man dieses Verzeichnis nicht benutzen wollen, so kann man dies in der munin.conf ändern.

# The next three variables specifies where the location of the RRD
# databases, the HTML output, and the logs, severally.  They all
# must be writable by the user running munin-cron.
dbdir   /var/lib/munin
htmldir /var/www/munin
logdir  /var/log/munin
rundir  /var/run/munin

Man sollte nicht vergessen das neue Verzeichnis selber zu erstellen und munin die Rechte mittels

chown munin:munin /var/www/domain/example.org/munin 

zu übergeben.

Anmerkung: in Ubuntu 10.04 wird das Datenverzeichnis per default in /var/cache/munin/www/ abgelegt. Hier reicht ein symlink in /var/www/, wenn man das Verzeichnis dort belassen und die conf nicht anpassen möchte (zumindest bei Verwendung eines alternativen www-servers wie lighttpd):

cd /var/www/
sudo ln -s /var/cache/munin/www/ munin 

Dann erreicht man die Seite von munin auch wie gewohnt über: http://host.domain.xy/munin/

Hosts¶

In der Standardeinstellung wird nur der "localhost", also der eigene Rechner von munin abgefragt.

# a simple host tree
[localhost.localdomain]
    address 127.0.0.1
    use_node_name yes

Hier kann man jedoch problemlos weitere Munin-Nodes hinzufügen. Also beispielsweise einfach

[webserver.beispiel]
    address 192.168.0.10
[sqlserver.beispiel]
    address 192.168.0.11

in die Konfigurationsdatei einfügen.

Warnungen verschicken¶

Munin kann beim Überschreiten festgelegter Werte automatisch Warnungen verschicken. So wird man als Administrator rechtzeitig gewarnt, wenn beispielsweise Plattenplatz knapp wird. Dazu muss in der munin.conf zuerst der Empfänger mittels der Zeilen

# Drop somejuser@fnord.comm and anotheruser@blibb.comm an email everytime
# something changes (OK -> WARNING, CRITICAL -> OK, etc)
contacts me
contact.me.command mail -s "Munin notification ${var:host}" user@example.com
contact.me.always_send warning critical

bestimmt werden. Die E-Mailadresse ist hier anzupassen. Voraussetzung für den Versand solcher Emails ist, dass ein MTA wie beispielsweise Postfix installiert und konfiguriert ist. Anschliessend kann man die kritischen Werte definieren, bei denen die Warnung abgeschickt werden soll. Dies geschieht bei jedem einzelnen Host in der Art

[localhost.localdomain]
    address 127.0.0.1
    use_node_name yes
    <plugin>.<feldname>.{critical,warning} <wert>

Hierbei sind für die Platzhalter zu ersetzen:

• "<plugin>" - Den Namen des Plugins bekommt man am einfachsten über die Url des Graphen. Am Ende der Url findet man den Namen wie z.B. beim Plugin zur Festplattenbelegung ".../localhost.localdomain-df.html". Das "df" wäre in diesem Fall der Pluginname.

• "<feldname>" - Die Feldnamen erfährt man wiederum, wenn man sich einen Graphen im Detail ansieht. Auf diesen Seiten sind am Ende die Feldnamen unter der Bezeichnung "Internal name" aufgeführt.

• "{critical,warning}" - Diese beiden Optionen sind frei wählbar und bestimmen ob eine "Warnung" oder eine "Kritische" Warnmeldung verschickt wird.

• "<wert>" - Dieser Wert ist frei wählbar und sollte entsprechend dem Wert gesetzt werden, ab dem die Warnung verschickt werden soll.

Letztendlich sieht dann ein Eintrag beispielsweise so aus:

[localhost.localdomain]
    address 127.0.0.1
    use_node_name yes
    df._dev_evms_hda2.warning 70
    df._dev_evms_hda2.critical 95
    df._dev_mapper_hda5.warning 70
    df._dev_mapper_hda5.critical 70

Weitere Plugins¶

Von Haus aus sind zahlreiche Plugins aktiviert. Im Verzeichnis /usr/share/munin/plugins findet man noch weitere Module, die man bei Bedarf hinzufügen kann. Prinzipiell geschieht dies durch das Setzen eines Links in das Verzeichnis /etc/munin/plugins/. Alle Plugins, die dort verlinkt sind, werden von Munin-Node beachtet.

./<plugin> autoconf 

yes

# Allgemein
./<plugin>_ suggest
# Beispiel
./sensors_ suggest 

fan
volt
temp

# Allgemein
munin-run <plugin>
# Beispiel
munin-run df 

_dev_evms_hda2.value 50
varrun_var_run.value 1
varlock_var_lock.value 1
procbususb.value 1
udev_dev.value 1
devshm_dev_shm.value 0
lrm_lib_modules_2_6_20_16_generic_volatile.value 11
_dev_mapper_hda1.value 57
_dev_mapper_hda5.value 78

# Normales Plugin
sudo ln -s /usr/share/munin/plugins/<modul> /etc/munin/plugins/
# Wildcard-Plugin
sudo ln -s /usr/share/munin/plugins/<modul>_ /etc/munin/plugins/<modul>_<ausgabe> 

sudo ln -s /usr/share/munin/plugins/sensors_ /etc/munin/plugins/sensors_fan
sudo ln -s /usr/share/munin/plugins/sensors_ /etc/munin/plugins/sensors_volt
sudo ln -s /usr/share/munin/plugins/sensors_ /etc/munin/plugins/sensors_temp 

# Allgemein
sudo ln -s /usr/share/munin/plugins/if_ /etc/munin/plugins/if_<schnittstelle>
sudo ln -s /usr/share/munin/plugins/if_err_ /etc/munin/plugins/if_err_<schnittstelle>
# Beispiel
sudo ln -s /usr/share/munin/plugins/if_ /etc/munin/plugins/if_ppp0
sudo ln -s /usr/share/munin/plugins/if_err_ /etc/munin/plugins/if_err_ppp0 

<IfModule mod_status.c>
#
# Allow server status reports generated by mod_status,
# with the URL of http://servername/server-status
# Uncomment and change the ".example.com" to allow
# access from other hosts.
#
ExtendedStatus On

<Location /server-status>
    SetHandler server-status
    Order deny,allow
    Deny from all
    Allow from localhost
    # Eventuell notwendig: Allow from <öffentliche IP-Addresse des Servers>
</Location>

</IfModule>

sudo a2enmod status 

sudo ln -s /usr/share/munin/plugins/apache_accesses /etc/munin/plugins/
sudo ln -s /usr/share/munin/plugins/apache_processes /etc/munin/plugins/
sudo ln -s /usr/share/munin/plugins/apache_volume /etc/munin/plugins/ 

sudo apt-get install libwww-perl