Vollständige Schritt-für-Schritt-Anleitung zur Einbindung von Didactum Monitoring-Geräten und Sensoren in Observium via SNMP – inklusive Gerät hinzufügen, MIB-Installation, Custom OIDs, OS-Definition, Alert Checks und E-Mail-Benachrichtigung.

Hinweis zu Observium-Editionen: 

Observium ist in zwei Varianten erhältlich. Die Community Edition (kostenlos) bietet grundlegendes SNMP-Monitoring ohne Alarmierungsfunktion per E-Mail. Die Professional / Subscription Edition enthält Alert Checks, E-Mail-Benachrichtigung, Custom OIDs und erweiterte MIB-Unterstützung. Die wichtigsten Funktionen dieser Anleitung (Custom OIDs, Alerting) erfordern die Subscription Edition.

• Software: Observium Community oder Professional/Subscription Edition
• Installationspfad: /opt/observium (Standard)
• Protokoll: SNMP v1 / v2c / v3
• Geräte: Didactum Monitoring System 100 / 500T / 500 II
• Sensoren: Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch

Observium-Server

• Ubuntu 20.04 / 22.04 LTS (empfohlen)
• Observium installiert unter /opt/observium
• LAMP-Stack (Apache, MySQL, PHP) installiert
• Pakete: snmp, snmp-mibs-downloader, rrdtool
• UDP-Port 161 ausgehend geöffnet (SNMP Polling)
• Netzwerkzugang zum Didactum-Gerät

Didactum-Gerät

• Monitoring System 100T, 300T, 500T oder 550T
• SNMP aktiviert (v2c oder v3)
• Pingbar und per SNMP vom Observium-Server erreichbar (Pflichtvoraussetzung)
• MIB-Datei im Web-Interface verfügbar

Architektur & Datenfluss

[Observium Server]              [Didactum Monitoring System]
  IP: 192.168.1.10                IP: 192.168.1.50
  Web: 192.168.1.10
  /opt/observium/
                    --SNMP Polling UDP 161 (alle 5 Min.)-->
                    <-- SNMP Walk / Get ---
                    --RRD-Daten gespeichert unter:
                      /opt/observium/rrd/

Wichtige Observium-Verzeichnisse

/opt/observium/                      <-- Hauptverzeichnis
/opt/observium/config.php            <-- Hauptkonfiguration
/opt/observium/mibs/                 <-- MIB-Dateien (eigene hinzufügen)
/opt/observium/includes/definitions/ <-- OS- und MIB-Definitionen
/opt/observium/rrd/                  <-- RRD-Datenbanken (Zeitreihen)
/opt/observium/logs/                 <-- Log-Dateien

Schritt 1 – Web-Interface öffnen

Im Browser aufrufen: 192.168.1.50 (IP des Didactum-Geräts anpassen)

Schritt 2 – SNMP-Einstellungen aufrufen

Systemeinstellungen → SNMP

Schritt 3 – Folgende Werte eintragen

Wichtig: Gerät muss pingbar sein

Observium prüft bei der Geräteanmeldung, ob das Gerät per ICMP erreichbar ist. Sicherstellen, dass das Didactum-Gerät auf Ping-Anfragen antwortet:

ping 192.168.1.50

Observium kann mehrere Community Strings speichern und nutzt diese automatisch beim Hinzufügen von Geräten.

Variante A – Community in config.php eintragen (empfohlen)

sudo nano /opt/observium/config.php

Folgende Zeilen hinzufügen:

// ============================================================
// SNMP Community Strings
// Observium probiert diese automatisch beim Gerät-Scan
// ============================================================

// SNMPv2c Communities
$config['snmp']['community'][] = "didactum_observium";
$config['snmp']['community'][] = "public";   // als Fallback, wenn nötig

// SNMPv3 Konfiguration (optional)
$config['snmp']['v3'][0]['authname']   = "observium_user";
$config['snmp']['v3'][0]['authpass']   = "IhrAuthPasswort";
$config['snmp']['v3'][0]['authalgo']   = "SHA";
$config['snmp']['v3'][0]['cryptopass'] = "IhrPrivPasswort";
$config['snmp']['v3'][0]['cryptoalgo'] = "AES";

Variante B – Community beim Hinzufügen des Geräts angeben

Beim manuellen Hinzufügen über das Web-Interface kann die Community direkt eingetragen werden (siehe Abschnitt 4).

Variante A – Über das Web-Interface

Devices → Add Device (oben rechts im Menü)

Auf Add Device klicken. Observium prüft sofort die SNMP-Verbindung und fügt das Gerät hinzu, wenn sie funktioniert.

Variante B – Über die Kommandozeile (CLI)

cd /opt/observium

# SNMPv2c – Standard
./add_device.php 192.168.1.50 didactum_observium v2c

# SNMPv2c mit Port und DNS-Name
./add_device.php didactum-monitor-01 didactum_observium v2c 161 udp

# SNMPv3 – mit Authentifizierung und Verschlüsselung
./add_device.php 192.168.1.50 ap v3 observium_user \
    IhrAuthPasswort IhrPrivPasswort sha aes 161 udp

Erwartete Ausgabe bei Erfolg:

  o  didactum-monitor-01 (192.168.1.50)
     SNMP Version v2c
     Community    didactum_observium
     Added device didactum-monitor-01.

Variante C – Mehrere Geräte auf einmal aus Textdatei

# Datei didactum-devices.txt erstellen:
# 192.168.1.50 didactum_observium v2c
# 192.168.1.51 didactum_observium v2c

./add_device.php didactum-devices.txt

Observium nutzt MIB-Dateien um OID-Nummern in Klartextnamen zu übersetzen und Sensoren automatisch zu erkennen.

Schritt 1 – MIB aus dem Didactum Web-Interface laden

Systemeinstellungen → SNMP → "MIB-Datei herunterladen" → didactum.mib

Schritt 2 – MIB in das Observium-MIB-Verzeichnis kopieren

# Eigenes Vendor-Verzeichnis für Didactum anlegen
sudo mkdir -p /opt/observium/mibs/didactum

# MIB-Datei kopieren
sudo cp didactum.mib /opt/observium/mibs/didactum/

# Alternativ: ins RFC-Verzeichnis (für allgemeine MIBs)
sudo cp didactum.mib /opt/observium/mibs/rfc/

Schritt 3 – SNMP-System-MIBs aktualisieren

sudo cp didactum.mib /usr/share/snmp/mibs/
echo "mibdirs /usr/share/snmp/mibs" | sudo tee -a /etc/snmp/snmp.conf
echo "mibs ALL" | sudo tee -a /etc/snmp/snmp.conf

Schritt 4 – MIB-Verbindung testen

# SNMP-Walk mit MIB-Namen testen
snmpwalk -v 2c -c didactum_observium -m ALL 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1

# OID-Translation testen
snmptranslate -m /opt/observium/mibs/didactum/didactum.mib \
    .1.3.6.1.4.1.46501.5.1.1.7.101001

Damit Observium das Didactum-Gerät korrekt erkennt, muss eine OS-Definition angelegt werden. Ohne diese Definition erscheint das Gerät als „Unknown".

Schritt 1 – OS-Definitionsdatei erstellen

sudo nano /opt/observium/includes/definitions/os/didactum.inc.php

Schritt 2 – Folgenden Inhalt eintragen

<?php
/**
 * Observium OS-Definition für Didactum Monitoring System
 * Datei: /opt/observium/includes/definitions/os/didactum.inc.php
 */

// OS-Bezeichner
$os = "didactum";

// Anzeigename und Metadaten
$config['os'][$os]['text']     = "Didactum Monitoring System";
$config['os'][$os]['type']     = "environment";
$config['os'][$os]['vendor']   = "Didactum";
$config['os'][$os]['icon']     = "didactum";

// Enterprise OID zur Geräteerkennung
// Ältere Geräte: .1.3.6.1.4.1.46501
// Neuere Geräte: .1.3.6.1.4.1.39052
$config['os'][$os]['sysObjectID'][] = ".1.3.6.1.4.1.46501";
$config['os'][$os]['sysObjectID'][] = ".1.3.6.1.4.1.39052";

// Alternativ: Erkennung über sysDescr
$config['os'][$os]['sysDescr'][] = "/[Dd]idactum/";
$config['os'][$os]['sysDescr'][] = "/[Mm]onitoring [Ss]ystem/";

// MIBs zuweisen
$config['os'][$os]['mibs'][] = "DIDACTUM-MIB";

// MIB-Verzeichnis angeben
$config['os'][$os]['mib_dirs'][] = "didactum";

Schritt 3 – Sensor-Definition für Temperatur anlegen

sudo nano /opt/observium/includes/definitions/mibs/didactum.inc.php

<?php
/**
 * Observium MIB-Definition für Didactum Sensoren
 * Datei: /opt/observium/includes/definitions/mibs/didactum.inc.php
 */

// Temperatursensor (digital, Sensor-ID 101001)
// Rohwert ÷ 10 = Grad Celsius
$config['mibs']['DIDACTUM-MIB']['sensor']['temperature']['indexes'][0] = array(
    'descr'      => 'Temperatursensor 01',
    'class'      => 'temperature',
    'measured'   => 'device',
    'oid_num'    => '.1.3.6.1.4.1.46501.5.1.1.7.101001',
    'oid_descr'  => '.1.3.6.1.4.1.46501.5.1.1.5.101001',
    'precision'  => 10,       // Teiler: Rohwert ÷ 10 = Grad Celsius
    'min'        => -40,
    'max'        => 80,
    'warn_min'   => 5,
    'warn_max'   => 28,
);

// Leckagesensor (Sensor-ID 107001)
$config['mibs']['DIDACTUM-MIB']['sensor']['gauge']['indexes'][0] = array(
    'descr'      => 'Leckagesensor 01',
    'class'      => 'state',
    'measured'   => 'device',
    'oid_num'    => '.1.3.6.1.4.1.46501.5.1.1.7.107001',
    'oid_descr'  => '.1.3.6.1.4.1.46501.5.1.1.5.107001',
);

// Luftfeuchtigkeit (Sensor-ID 102001)
$config['mibs']['DIDACTUM-MIB']['sensor']['humidity']['indexes'][0] = array(
    'descr'      => 'Luftfeuchtigkeit 01',
    'class'      => 'humidity',
    'measured'   => 'device',
    'oid_num'    => '.1.3.6.1.4.1.46501.5.1.1.7.102001',
    'oid_descr'  => '.1.3.6.1.4.1.46501.5.1.1.5.102001',
    'min'        => 0,
    'max'        => 100,
    'warn_min'   => 20,
    'warn_max'   => 80,
);

Schritt 1 – Discovery manuell starten

Discovery erkennt Gerättyp, Sensoren und verfügbare MIBs:

cd /opt/observium

# Vollständige Discovery für Didactum-Gerät
./discovery.php -h didactum-monitor-01

# Discovery nur für den OS-Erkennungsmodul
./discovery.php -h didactum-monitor-01 -m os

# Discovery nur für Sensoren
./discovery.php -h didactum-monitor-01 -m sensors

# Mit Debug-Ausgabe (sehr ausführlich)
./discovery.php -h didactum-monitor-01 -d

Schritt 2 – Polling manuell starten

Polling ruft die aktuellen Messwerte ab und speichert sie in RRD:

cd /opt/observium

# Polling für Didactum-Gerät
./poller.php -h didactum-monitor-01

# Mit Debug-Ausgabe
./poller.php -h didactum-monitor-01 -d

Schritt 3 – Sensoren im Web-Interface prüfen

Web-Interface: 192.168.1.10
→ Devices → didactum-monitor-01
→ Reiter "Health" oder "Sensors"
→ Erkannte Sensoren werden hier angezeigt

Schritt 4 – Automatisches Polling sicherstellen (Cron)

# Cron-Einträge prüfen
sudo crontab -l -u www-data

# Falls nicht vorhanden, hinzufügen:
sudo crontab -e -u www-data

Folgenden Inhalt in die Crontab eintragen:

# Observium Cron-Jobs
# Polling alle 5 Minuten
*/5 * * * * /opt/observium/poller-wrapper.py 16 >> /dev/null 2>&1

# Discovery täglich um 01:33 Uhr
33 1 * * * /opt/observium/discovery.php -h all >> /dev/null 2>&1

# Discovery neuer Geräte alle 5 Minuten
*/5 * * * * /opt/observium/discovery.php -h new >> /dev/null 2>&1

# Alerter nach jedem Polling-Lauf
*/5 * * * * /opt/observium/alerter.php >> /dev/null 2>&1

Custom OIDs ermöglichen die direkte Abfrage und Visualisierung beliebiger SNMP-OIDs – ideal für Sensoren, die von der automatischen Discovery nicht erkannt wurden.

Navigation im Web-Interface

Global Menü (Globus-Symbol) → Custom OID → Add Custom OID

Custom OID: Temperatursensor

Nach dem Speichern: auf Associate Devices klicken und didactum-monitor-01 auswählen.

Custom OID: Leckagesensor

Custom OID: Luftfeuchtigkeit

Custom OID: Türkontakt

Custom OID: Sensor-Status

Custom OIDs in Grafiken anzeigen

Web-Interface → Devices → didactum-monitor-01
→ Reiter "Graphs" → "Custom"
→ Zeitverlaufs-Graphen der abgefragten OIDs

Nach dem ersten Eintragen werden nach ca. 15 Minuten (nach dem nächsten Polling-Lauf) Graphen angezeigt.

Alert Checks prüfen kontinuierlich gesammelte Messwerte gegen Schwellwerte und lösen bei Überschreitung eine Benachrichtigung aus.

Navigation

Alerts → Alert Checks → Add Alert Check

Alert Check: Temperatur zu hoch

Zweiten Alert Check mit Severity Critical anlegen:

Alert Check: Leckage

Alert Check: Gerät nicht erreichbar

Alert Check dem Gerät zuweisen

Alerts → Alert Checks → [Alert Check auswählen]
→ Reiter "Matches" → "Add device match"
→ Gerät: didactum-monitor-01 auswählen → Save

Schritt 1 – E-Mail-Einstellungen in config.php

sudo nano /opt/observium/config.php

// ============================================================
// E-Mail-Einstellungen für Observium
// ============================================================

// Absender
$config['email']['from']    = '"Observium Didactum" <observium@ihredomain.de>';

// Standard-Empfänger (erhält alle Alarme)
$config['email']['default'] = 'admin@ihredomain.de';

// Mail-Backend: 'mail' (PHP), 'sendmail' oder 'smtp'
$config['email']['backend']  = 'mail';

// Grafiken in E-Mail einbetten (Subscription Edition)
$config['email']['graphs']   = TRUE;

// Für SMTP-Versand (Backend = 'smtp'):
// $config['email']['smtp_host']   = 'mail.ihredomain.de';
// $config['email']['smtp_port']   = 587;
// $config['email']['smtp_secure'] = 'tls';
// $config['email']['smtp_auth']   = TRUE;
// $config['email']['smtp_user']   = 'observium@ihredomain.de';
// $config['email']['smtp_pass']   = 'IhrSMTPPasswort';

// Wie oft bei dauerhaftem Alarm wiederholen (Sekunden)
// Standard: 86400 = 1 Tag
$config['alerts']['interval'] = 3600;  // Jede Stunde wiederholen

Schritt 2 – Postfix für lokalen Mailversand installieren (empfohlen)

sudo apt install postfix mailutils -y
# Konfigurationstyp: "Internet Site" wählen
# Test:
echo "Testmail Observium" | mail -s "Test" admin@ihredomain.de

Schritt 3 – Notification Transport anlegen (Subscription Edition)

Web-Interface → Alerts → Notification Transports → Add Transport

Schritt 4 – Kontakt anlegen und mit Transport verknüpfen

Web-Interface → Alerts → Contacts → Add Contact
  Contact Name:    Administrator
  Email:           admin@ihredomain.de
  Transport:       Didactum E-Mail Admin

Schritt 5 – Alert Check mit Kontakt verknüpfen

Alerts → Alert Checks → [Alert Check bearbeiten]
→ Contacts → Add Contact → Administrator → Save

Schritt 6 – E-Mail-Versand testen

cd /opt/observium

# Alert-Test (neuere Versionen)
php test_alert.php -h didactum-monitor-01

# Alerter manuell starten
./alerter.php

Alle Didactum-OIDs beginnen mit .1.3.6.1.4.1.46501 (ältere Firmware) bzw. .1.3.6.1.4.1.39052 (neuere Modelle). Die Sensor-ID wird am Ende angehängt.

OID-Felder je Sensor

Sensortypen mit OIDs

Sensor-ID herausfinden: 

Im Didactum Web-Interface unter Systembaum → Sensor auswählen → Details. Diese ID wird ans Ende der OID angehängt.

Divisor in Observium: 

Der Divisor-Wert 10 beim Custom OID für Temperatur bewirkt, dass Observium den Rohwert automatisch durch 10 teilt. Rohwert 255 wird dann als 25,5 °C gespeichert und angezeigt.

MIB-Prefix je Modell: 

Ältere Geräte verwenden .1.3.6.1.4.1.46501, neuere Modelle eventuell .1.3.6.1.4.1.39052. Entnehmen Sie die genauen OIDs der MIB-Datei Ihres Geräts.

SNMP-Verbindung testen

# Einfacher Ping-Test
ping 192.168.1.50

# SNMP-Verbindung testen
snmpget -v 2c -c didactum_observium 192.168.1.50 sysDescr.0

# Alle Sensoren auflisten
snmpwalk -v 2c -c didactum_observium 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1

# Temperaturwert direkt abfragen
snmpget -v 2c -c didactum_observium 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1.7.101001

Discovery im Debug-Modus

cd /opt/observium

# Vollständige Discovery mit Debug-Ausgabe
./discovery.php -h didactum-monitor-01 -d 2>&1 | tee /tmp/didactum-discovery.log

# Nur OS-Erkennung debuggen
./discovery.php -h didactum-monitor-01 -m os -d

# Nur Sensor-Discovery debuggen
./discovery.php -h didactum-monitor-01 -m sensors -d

Polling im Debug-Modus

./poller.php -h didactum-monitor-01 -d 2>&1 | tee /tmp/didactum-poll.log

# Vollständigen SNMP-Dump speichern (für Fehleranalyse)
cd /opt/observium
./snmpwalk.php -h didactum-monitor-01

# Datei wird gespeichert als: didactum-monitor-01.snmpwalk

Fehlermeldungen und Lösungen

# Observium eigene Logs
sudo tail -f /opt/observium/logs/observium.log

# PHP-Fehler
sudo tail -f /var/log/apache2/error.log

# Poller-Log
sudo tail -f /opt/observium/logs/poller.log

Didactum-Gerät

• SNMP aktiviert (v2c)
• Community String gesetzt (nicht „public")
• Gerät ist pingbar vom Observium-Server
• snmpwalk-Test vom Observium-Server erfolgreich
• MIB-Datei heruntergeladen

Observium-Server

• Pakete snmp, snmp-mibs-downloader installiert
• Community String in config.php eingetragen
• MIB-Datei unter /opt/observium/mibs/didactum/ gespeichert
• OS-Definition /opt/observium/includes/definitions/os/didactum.inc.php angelegt
• Gerät per add_device.php oder Web-Interface hinzugefügt
• Discovery erfolgreich: Gerät hat OS-Typ „didactum"
• Cron-Einträge für Polling und Discovery gesetzt

Sensoren & Custom OIDs (Subscription Edition)

• Custom OID für Temperatursensor mit Divisor 10 angelegt
• Custom OID für Leckagesensor angelegt
• Custom OID für Luftfeuchtigkeit angelegt
• Custom OID dem Gerät didactum-monitor-01 zugewiesen
• Nach 15 Minuten: Graphen unter Devices → Custom sichtbar

Alerting & Benachrichtigung (Subscription Edition)

• E-Mail-Einstellungen in config.php konfiguriert
• Postfix / Mailversand funktioniert (Test-Mail erhalten)
• Notification Transport für E-Mail angelegt
• Kontakt mit E-Mail-Adresse angelegt
• Alert Check „Temperatur zu hoch" angelegt und Gerät zugewiesen
• Alert Check „Leckage ALARM" angelegt (sofort, Critical)
• Alert Check „Device Down" angelegt
• Test-Alarm ausgelöst und E-Mail empfangen