Co je Munin?

Munin je flexibilní nástroj pro vytváření grafů snad jakýchkoliv údajů, které lze z počítače dostat. Vlastní tvorbu grafů a případně jiných výstupů má na starosti z cronu spouštěný skript, který zpracovává data ze serverů, na kterých běží sběrač dat munin-node. Vlastní data získávají pluginy, kterých již existuje velké množství, ale v případě potřeby je velmi snadné napsat vlastní plugin. Grafy jsou vykreslovány pomocí známého RRDtoolu, takže o jejich kvalitu se není třeba obávat.

Instalace

Nejjednodušší cesta je v případě, že vaše distibuce již munin obsahuje, pak jen stačí použít její balíčkovací systém a vše potřebné (na server který bude generovat grafy balíček munin, na monitorované servery munin-node) nainstalovat:

aptitude install munin munin-node

Pro některé distibuce jsou na stránkách projektu k dispozici balíčky, ostatní si budou muset vystačit s ruční instalací která je popsána v tarballu (upravení instalačních cest, přidání uživatele, vytvoření záznamu v cronu a init skriptu).

Co monitorovat?

Na monitorovaných servech je potřeba ještě aktivovat správné pluginy. Jelikož většina z nich podporuje automatickou konfiguraci, je základní výběr poměrně snadný (některé distribuční balíčky toto dělají automaticky):

munin-node-configure --shell | sh

Pokud vygerenovaný seznam nevyhovuje, je možné ručně přidat další pluginy (do adresáře /etc/munin/plugins). U pluginů které vyžadují jediný parametr se tento často udává jen jménem souboru (resp. symbolického odkazu). Takže třeba statistiky pingu na google.com začneme sbírat po vytvoření následujícího odkazu (a restartování munin-node):

ln -s /usr/share/munin/plugins/ping_ ping_google.com

Složitější nastavení se již zapisuje do konfiguračního souboru /etc/munin/plugin-conf.d/munin-node. Pokud použijete balíčky, opět budete mít ušetřenu práci díky předvyplněným parametrům pro mnoho služeb.

Poslední úkol, který před námi stojí je zadat seznam monitorovaných serverů do /etc/munin/munin.conf, a pak již se nám začnou sbírat data:

[a.example.com]
    address localhost
[b.example.com]
    address b.example.com

Výstupy

Hlavním výstupem jsou pro Munin grafy. Jak to může vypadat je vidět na demonstrační instalaci. Na úvodní stránce je přehledně vidět, které parametry se dostaly do nebezpečných hodnot, dále se již dostaneme na grafy jednotlivých parametrů.

Kromě grafů je možné také nastavit notifikaci v případě překročení limitů. Notifikace může mít libovolnou podobu, nejjednodušší je asi posílat email, až po propojení s Nagiosem. Vše se nastavuje na monitorovacím serveru v souboru /etc/munin/munin.conf. Inspirovat se můžeme třeba příklady v ukázkové konfiguraci a nastavit posílání emailů:

contact.someuser.command mail -s "Munin notification" somejuser@fnord.comm

Pokud chceme různá varování zpracovat jiným způsobem (třeba některá přeposílat na mobil), je vhodné ještě vynutit posílání každé události v samostatném mailu:

contact.someuser.max_messages 1

Vlastní plugin

I když spektrum již napsaných pluginů je poměrně široké, stejně se může stát, že monitorování nějaké veličiny ještě nikdo nepotřeboval, a budeme si muset pomoci sami. Naštěstí pluginy pro Munin se píší snadno a můžete si pro ně vybrat libovolný programovací jazyk, takže by to neměl být velký problém. Jen je potřeba mít na paměti, že plugin se pouští poměrně často a neměl by být příliš náročný.

Jako ukázkový vytvoříme plugin pro čtení teploty z jednoduchého teplotního čidla připojeného na sériový port, které přímo vypisuje hodnoty teploty.

Nejjednodušší je asi použít shell, takže tedy skriptu dáme standardní hlavičku:

#!/bin/sh

Jméno sériového portu určíme z názvu spuštěného programu:

name=`basename $0 | sed 's/^temp_//g'`

Na parametr config musí plugin odpovědět parametry pro grafy. Lze nastavit prakticky vše co RRDtool umí, dále zadáváme název grafu a os, kategorii, ve které se má plugin zobrazit (graph_category) a dále nejméně jednu položku, která nadefinuje monitorovaná data (název.label):

if [ "$1" = "config" ]; then
    echo graph_title Temperature on $name
    echo 'graph_args --base 1000 -l 0'
    echo 'graph_category temperature'
    echo "graph_vlabel temp in °C"
    echo "temp.label $name"
    exit 0
fi

Protože se náš plugin umí sám nastavit, na parametr autoconf odpovíme yes:

if [ "$1" = "autoconf" ]; then
    echo yes
    exit 0
fi

Ostatní parametry si můžeme dovolit ignorovat a přímo vypsat aktuální hodnotu měření ve formátu název.value hodnota. Pro náš konkrétní případ je potřeba nastavit správné parametry sériovému portu a pak již jen upravit přečtené číslo do správné podoby:

stty -F /dev/$name 500:5:cbd:8a3b:3:1c:7f:15:4:0:1:0:11:13:1a:
0:12:f:17:16:0:0:0:0:0:0:0:0:0:0:0:0:0:0:0:0
# výše uvedený text je celý na jednom řádku!
echo -n "temp.value "
head -n 1 /dev/$name  | tr -d C+

Podrobnější popis psaní pluginů samozřejmě najdete v dokumentaci, nebo ještě lépe na wiki projektu.

Pár slov na závěr

Munin je opravdu snadno nastavitelný systém, který díky automatické konfiguraci je dokonce schopný monitorovat základní parametry s minimální snahou obsluhy. Rozšiřitelnost dalšími pluginy je opravdu snadná a zvládne to kdokoliv se základní znalostí libovolného jazyka, ve kterém se rozhodne data spravovat.

Drobnou vadou na kráse může být nemožnost konfigurovat intervaly měření (což by měly opravit nové verze). Dále určitě nepotěší nenažranost některých monitorovacích pluginů, které si zaslouží přepsat. Většina z nich ovšem již má své nástupce v bug trackeru, takže se tato situace snad také zlepší.

Takže pokud chcete snadno získat přehled o stavu svých serverů, Munin může být ta správná volba pro vás.