01 Oct 2023

FreeBSD: Munin-Howto

Eine Installation von Munin unter FreeBSD ist eigentlich selbsterklärend. Diese Notiz ist deshalb nur für mich, wenn ich das später nochmal tun muss, und es kurz vergessen habe.

Pakete aus dem Portage-Tree installieren
- munin-node
- munin-master

cd /usr/ports/sysutils/munin-node
make all install clean
cd /usr/ports/sysutils/munin-master
make all install clean

Daemons enabeln
- vi /etc/rc.conf

munin_node_enable="YES"

Testen der Installation als User munin
- Cron-Job kontrollieren

root@gliese1:~ # su munin
root@gliese1:~ # crontab -l
#BEGIN_MUNIN_MAIN
MAILTO=root

*/5 * * * *     /usr/local/bin/munin-cron
#END_MUNIN_MAIN

Cron-Job als User Munin(!!!) erstmal manuell ausführen

$  /usr/local/bin/munin-cron
[FATAL] There is nothing to do here, since there are no nodes with any plugins.

Plugins als root konfigurieren

# munin-node-configure --suggest --shell

# mysql_:
#       Wrong amount of autoconf: expected 1 line, got 5 lines:
#       [start]no (install_driver(mysql) failed: Can't locate DBD/mysql.pm in @INC (you may need to install the D...

Offensichtlich fehlt der Perl-Mysql-Treiber. Schnell nachinstallieren!
```
# cd /usr/ports/databases/p5-DBD-mysql/
# make all install clean
```
Jetzt nochmals die Plugins mit symlinks oder mit munin-node-configure konfigureren. Hier die manuelle Methode.

# root@gliese1: # ls -lha /usr/local/etc/munin/plugins/
lrwxr-xr-x  1 root  wheel    34B Oct  7 13:51 cpu -> /usr/local/share/munin/plugins/cpu
lrwxr-xr-x  1 root  wheel    33B Oct  7 13:49 df -> /usr/local/share/munin/plugins/df
lrwxr-xr-x  1 root  wheel    47B Oct  7 13:50 hddtemp -> /usr/local/share/munin/plugins/hddtemp_smartctl
lrwxr-xr-x  1 root  wheel    37B Oct  7 13:50 iostat -> /usr/local/share/munin/plugins/iostat
lrwxr-xr-x  1 root  wheel    35B Oct  7 13:50 load -> /usr/local/share/munin/plugins/load
lrwxr-xr-x  1 root  wheel    37B Oct  7 13:50 memory -> /usr/local/share/munin/plugins/memory
lrwxr-xr-x  1 root  wheel    38B Oct  7 13:50 netstat -> /usr/local/share/munin/plugins/netstat
lrwxr-xr-x  1 root  wheel    35B Oct  7 13:51 swap -> /usr/local/share/munin/plugins/swap
lrwxr-xr-x  1 root  wheel    37B Oct  7 13:51 systat -> /usr/local/share/munin/plugins/systat

Wichtig! jetzt munin-node neu starten

# service munin-node restart

jetzt nochmals als User munin testen:

root@gliese1:~ # su - munin

$ /usr/local/bin/munin-cron

Hier noch Teil der Nginx-Konfiguration, der Vollständigkeit halber
- /usr/local/etc/nginx/nginx.conf

#MUNIN
  server 
  {
        listen      127.0.0.1:33331;
        server_name 127.0.0.1:33331;
        root /usr/local/www/munin/;
        allow 127.0.0.1;
        deny all;
        autoindex on;

        location ^~ /usr/local/www/cgi-bin/ {
            fastcgi_split_path_info ^(/munin-cgi/munin-cgi-graph)(.*);
            fastcgi_param PATH_INFO $fastcgi_path_info;
            fastcgi_pass unix:/var/run/munin/fastcgi-graph.sock;
            include fastcgi_params;
    }

    location /munin/static/ {
            alias /usr/local/etc/munin/static/;
    }

    location /munin/ {
            fastcgi_split_path_info ^(/munin)(.*);
            fastcgi_param PATH_INFO $fastcgi_path_info;
            fastcgi_pass unix:/var/run/munin/fastcgi-html.sock;
            include fastcgi_params;
    }
  }