Mit dem Raspberry Pi sind viele Dinge möglich, zum Beispiel auch Netzwerküberwachung mit Nagios, Cacti oder MRTG. Aber auch Observium funktioniert einwandfrei mit einem Raspberry Pi. Bei kleineren Netzwerken (Heimnetzwerk)) läuft Observium auch relativ flüssig auf einem Raspberry Pi 1 Modell B+. Für mittlere bis große Netze empfiehlt sich aber der Einsatz eines Raspberry Pi 2 oder 3 in der größten Variante.
Ausgangsbasis ist eine Raspbian Installation und SSH Zugang. Die Einrichtung läuft zu 100% über die Konsole, nach der Installation von Raspbian braucht man also keinerlei Monitor und HDMI Kabel mehr. Im weiteren Verlauf werden wir auch den Observium Agent einrichten und auf allen dafür geeigneten Systemen (*nix/Linux) zum laufen bringen.
Fangen wir mit der grundlegenden Installation aller benötigten Pakete an, hierzu verbindet Ihr euch mit eurem Raspberry Pi per SSH und gebt folgende Zeilen ein:
|
1 2 3 4 5 6 |
sudo bash apt-get install apache2 libapache2-mod-php5 php5-cli php5-mysql php5-gd \ php5-mcrypt php5-json php-pear snmp snmpd fping mysql-server mysql-client \ python-mysqldb rrdtool subversion whois mtr-tiny ipmitool graphviz \ imagemagick xinetd netcat snmp-mibs-downloader |
Das ist die Grundinstallation und sollte euch alle benötigten Pakete installieren und vorkonfigurieren. Bei der MySQL Installation werdet ihr nach einem Passwort gefragt, das Ihr frei vergeben und Euch merken dürft.
Anschließend legen wir die erforderlichen Verzeichnisse an und laden die aktuelle Observium CE herunter und entpacken sie nach /opt, es wird automatisch in das richtige Unterverzeichnis entpackt.
|
1 2 3 |
mkdir -p /opt/observium && cd /opt wget http://www.observium.org/observium-community-latest.tar.gz tar zxvf observium-community-latest.tar.gz |
Nun legen wir eine Standardkonfiguration an indem wir im Verzeichnis von Observium die Beispiel Konfiguration kopieren.
|
1 2 |
cd /opt/observium cp config.php.default config.php |
Editiert die config.php mit einem Editor eurer Wahl (Ich bevorzuge nano.) und tragt die Standard MySQL Daten für Benutzer und Passwort (Das was ihr vorher vergeben habt.) ein. Alternativ wer sich gut genug mit MySQL auskennt und Bedenken hat dem MySQL Root User zu verwenden, legt im nächsten Schritt noch zusätzlich einen Benutzer und Passwort für Observium fest und verteilt die benötigten Rechte.
Tragt noch folgende Zeile in die config.php mit ein:
|
1 |
$config['poller_modules']['unix-agent'] = 1; |
Darauf wechseln wir nun zu MySQL und legen die Datenbank an:
|
1 2 3 |
mysql -u root -p mysql> CREATE DATABASE observium DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; mysql> \q |
Optionaler Schritt: Benutzername und Passwort für die Observium Datenbank anlegen und Rechte geben.
|
1 2 3 |
mysql> GRANT ALL PRIVILEGES ON observium.* TO 'observium'@'localhost' -> IDENTIFIED BY '<observium db password>'; mysql> flush privileges; |
Nun sind wir wieder im /opt/observium Verzeichnis und können die Datenbank mit den Basisdaten befüllen.
|
1 |
./discover.php -u |
Jetzt legen wir noch die benötigten Verzeichnisse für die Logs und die RRD Daten an und setzen die Ordnerrechte.
|
1 2 3 |
mkdir logs mkdir rrd chown www-data:www-data rrd |
Jetzt müssen noch in Apache einen Host anlegen, wir gehen hier von Port 80 aus, aber Ihr könnt auch jeden anderen Port benutzen. Hierzu editiert ihr die Datei /etc/apache2/sites-available/000-default.conf. Kommentiert oder löscht die vorhandenen Einträge aus und fügt folgenden Inhalt ein.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
<VirtualHost *:80> ServerAdmin webmaster@localhost DocumentRoot /opt/observium/html <FilesMatch \.php$> SetHandler application/x-httpd-php </FilesMatch> <Directory /> Options FollowSymLinks AllowOverride None </Directory> <Directory /opt/observium/html/> DirectoryIndex index.php Options Indexes FollowSymLinks MultiViews AllowOverride All Require all granted </Directory> ErrorLog ${APACHE_LOG_DIR}/error.log LogLevel warn CustomLog ${APACHE_LOG_DIR}/access.log combined ServerSignature On </VirtualHost> |
Nun noch testen ob folgende Einstellungen für PHP und Apache2 schon durchgeführt wurden (In meinem Fall waren sie es, aber sicher ist sicher.).
|
1 2 3 4 5 |
php5enmod mcrypt a2dismod mpm_event a2enmod mpm_prefork a2enmod rewrite apache2ctl restart |
Jetzt legen wir unseren ersten Benutzer mit Level 10 (Administrator) an, geht sicher das ihr immer noch in /opt/observium seid.
|
1 |
./adduser.php <username> <password> <level> |
Anschließend brauchen wir noch einen Cronjob, damit der Pooler auch die Daten regelmäßig abfragt. Hierzu legen wir die Datei /etc/cron.d/observium an. Die Zahl 2 in der letzten Zeile gibt die Anzahl der Pooler Threads an, hier kann man bei Bedarf (Nicht auf einem Raspberry Pi 1, dafür ist das System zu schwach.) auch 4 Threads daraus machen. 2 Threads sind aber in kleineren bis mittleren Netzwerken ausreichend.
|
1 2 3 |
33 */6 * * * root /opt/observium/discovery.php -h all >> /dev/null 2>&1 */5 * * * * root /opt/observium/discovery.php -h new >> /dev/null 2>&1 */5 * * * * root /opt/observium/poller-wrapper.py 2 >> /dev/null 2>&1 |
Kommen wir nun bevor wir Anfangen Geräte hinzuzufügen erst einmal zum installieren und einrichten des UNIX Agents und einiger brauchbaren Scripte, die mit Observium mitgeliefert werden. Außerdem passen wir SNMPD an, das wir per SNMP v3 verbinden können (SNMP v1 oder v2 würde zwar reichen, aber ich bevorzuge v3.).
Hierzu brauchen wir aber ein paar grundlegende Vorbedingungen auf allen Hosts, die gemonitort werden sollen, und die über ein *nix/Linux OS verfügen. Wir reden hier von einfachen Servern und Workstations. Extras wie ein NAS oder Switches werden später nochmal erwähnt, hier wird meistens keine Sonderbehandlung nötig.
Wenn ihr außerdem noch andere Raspberry Pis mit Mediacenter monitoren wollt, müsst ihr leider auf OpenElec verzichten, da es hier aktuell keine Möglichkeit gibt einfach benötigte Pakete nach zu installieren, als Alternative bietet sich hier aber OSMC an, bei dem man alles nachinstallieren kann und auch den UNIX Agent zum laufen bringt. Sonderfälle wie RetroPie oder auch RecalBox habe ich noch nicht ausprobiert, werde ich aber eventuell noch machen. Raspberrys mit normalen Distros sollten kein Thema sein.
Weiter geht es, erst mal die Vorbedingungen installieren auf den zu monitorenden Systemen.
|
1 |
sudo apt-get install snmp snmpd snmp-mibs-downloader xinetd |
Öffnet die /etc/snmp/snmp.conf auf dem Raspberry Pi (Und jedem *nix/Linux Host den Ihr später monitoren wollt.) und kommentiert folgende Zeile mit # aus.
|
1 |
mibs: |
Nun widmen wir uns der /etc/snmp/snmpd.conf und machen einige Änderungen. Erstmal im ersten Teil der snmpd.conf folgende Änderungen vornehmen.
|
1 2 3 4 |
# Listen for connections from the local system only #agentAddress udp:127.0.0.1:161 # Listen for connections on all interfaces (both IPv4 *and* IPv6) agentAddress udp:161,udp6:[::1]:161 |
Danach legen wir einen User an namens “public” und einem Kennwort eurer Wahl, das mindestens 10 Zeichen lang sein sollte. Dazu legen wir fest, das dieser User ein Read-Only User ist, wer sich nicht scheut, kann anstelle von rouser auch rwuser nehmen falls er später den Raspberry auch für SNMP Verwaltungsaufgaben nutzen möchte.
|
1 2 |
createUser public MD5 temp_password DES rouser public priv |
Nun sucht ihr folgenden Bereich und editiert ihn, wie Ihr ihn braucht. Wer sich die man-Pages ansieht, kann auch hier weitere Felder hinzufügen. Zeile 8 und 9 sind Beispiele was noch geht und so nicht in der snmpd.conf drin steht.
|
1 2 3 4 5 6 7 8 9 |
# SYSTEM INFORMATION # # Note that setting these values here, results in the corresponding MIB objects being 'read-only' # See snmpd.conf(5) for more details sysLocation Eure Systemlocation sysContact eure@email.adresse sysDescr Observium Server sysName ObserviumPi |
Danach starten wir den snmpd Service neu.
|
1 |
sudo service snmpd restart |
Nun kommen wir zum UNIX Agent von Observium, der relativ einfach einzurichten ist. Das ganze machen wir wieder auf dem Raspberry Pi, auf dem Observium läuft, zumindest die Kopiererei des Agents und der Xinetd Konfiguration, sowie die zu kopierenden Module.
Fangen wir an und kopieren erst mal den Agent und die Konfiguration vom Server auf die Hosts.
|
1 2 |
scp /opt/observium/scripts/observium_agent_xinetd user@your_server:/etc/xinetd.d/observium_agent_xinetd scp /opt/observium/scripts/observium_agent user@your_server:/usr/bin/observium_agent |
Auf dem Server könnt ihr die Dateien ebenfalls kopieren, lasst einfach user@your_server: weg und anstatt scp nutzt Ihr cp. Danach setzt ihr noch den Agent auf Ausführbar mit:
|
1 |
sudo chmod +x /usr/bin/observium_agent |
Nun legen wir noch zwei wichtige Verzeichnisse für den Agent an, in dem auch später die Scripte kopiert werden. Dieses müsst ihr auf allen Hosts machen, die den Agent nutzen sollen.
|
1 2 |
sudo mkdir /usr/lib/observium_agent sudo mkdir /usr/lib/observium_agent/local |
Anschliessend bearbeitet ihr auf allen Hosts, auf die Ihr die observium_agent_xinetd kopiert hab eben diese Datei und kommentiert die Zeile only_from aus. Damit erlaubt ihr allen Observium Installationen im Netzwerk Zugriff auf den Agent. Wer hier wieder Bedenken hat, kann auch folgende Eintragung machen für die Hosts.
|
1 |
only_from = 192.168.0.0 |
Auf dem Observium Server müsst ihr die Datei nicht ändern, hier steht schon die richtige IP, also Localhost bzw. 127.0.0.1 drin. Danach startet ihr den xinetd Service neu.
|
1 |
sudo service xinetd restart |
Nun können wir anfangen die Scripte zu kopieren, die wir haben wollen. Schaut euch im /opt/observium/scripts/agent_local Verzeichnis um, welche Scripte es gibt für den Agent und welche Ihr haben wollt. Teilweise brauchen die Scripte auch Anpassungen wie das Script temperature oder kleine Besonderheiten wie das hddtemp Script (Bei mir führte es zu Problemen auf den Hosts, weswegen ich zur Zeit auf HDDtemp verzichte.). Beim MySQL Script müsst ihr auf jeden Fall auch die mysql.cnf mit kopieren.
Kopiert einfach die Scripte in den /local Ordner, den Ihr vorher angelegt habt, zum Beispiel wie folgt.
|
1 |
scp /opt/observium/scripts/agent-local/raspberrypi user@your_server:/usr/lib/observium_agent/local/raspberrypi |
Vergesst nicht den die Scripte wieder mit chmod +x ausführbar zu machen, sonst funktionieren sie nicht.
Nun könnt Ihr auf den Observium Server verbinden und meldet euch mit Benutzername und Kennwort, die Ihr vorher festgelegt habt an. Dann geht ihr auf Devices und Add Device. Dort gebt ihr den Hostnamen an, stellt auf Protocollversion v3 ein und stellt dann auf der rechten Seite den Benutzernamen und das Kennwort ein.
In diesem Beispielscreenshot habe ich die Beispieldaten eingetragen, damit Ihr seht welche Einstellungen Anhand unserer vorgenommenen Einstellungen in der snmpd.conf gemacht werden müssen. Nach dem Hinzufügen dauert es noch ca. 5-10 Minuten, bis der Host vollständig erfasst und gepollt wurde.
Bedenkt, das nur Hosts mit Hostnamen hinzugefügt werden können, Observium kann nicht mit IP Adressen umgehen. Aber auch hierfür gibt es eine Einfache Lösung, in Form der hosts Datei des Betriebssystems. Solltet ihr ein Gerät haben, das keinen Hostnamen hat, sondern nur eine IP, editiert ihr die /etc/hosts und fügt euren Host hinzu, zum Beispiel:
|
1 |
192.168.0.2 managed_switch |
Nun könnt ihr den Host anhand des von euch vergebenen Hostnamens in der hosts Datei hinzufügen. Geräte, auf denen Ihr nicht wisst, welche SNMP Version zu nutzen ist, solltet ihr immer erst mit v2c probieren, wenn es gar nicht anders geht mit v1. Wenn ein Gerät sich überhaupt nicht hinzufügen lässt, da kein SNMP vorhanden, dann geht es leider nicht.
Kommen wir noch zum Thema NAS, Drucker und Switches (Managed, Smart Managed), diese werden meistens von Observium direkt erkannt und stellen eine Vielzahl von Informationen zur Verfügung. Ich habe hier noch 3 Screenshots meiner Synology DS1812+ angehängt. Diese hab ich einfach mit v1 hinzugefügt und musste auf der Synology nur noch SNMP aktivieren, schon waren alle Werte und Graphen da.
Somit habt ihr nun einen Observium Server im Netzwerk, der euch hoffentlich hilft und viele nützliche Infos bringt.