Vollständige Schritt-für-Schritt-Anleitung zur Einbindung von Didactum Monitoring-Geräten und Sensoren in Opsview Monitor via SNMP – inklusive Host-Konfiguration, MIB-Import, SNMP Walk, SNMP Polling Service Checks, SNMP Traps, Host Template und E-Mail-Benachrichtigung.

• Software: Opsview Monitor (On-Premises oder Cloud)
• Protokoll: SNMP v1 / v2c / v3
• Geräte: Didactum Monitoring System 100T / 300T / 500T / 550T
• Sensoren: Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch

Opsview Monitor Server

• Opsview Monitor installiert (On-Premises oder Cloud)
• Web-Interface erreichbar (Standard: <Server-IP>)
• UDP-Port 161 ausgehend für SNMP Polling geöffnet
• UDP-Port 162 eingehend für SNMP Traps geöffnet
• Netzwerkzugang zum Didactum-Gerät

Didactum-Gerät

• Monitoring System 100T, 300T, 500T oder 550T
• SNMP aktiviert (v2c empfohlen)
• Gerät per ICMP (Ping) vom Opsview-Server erreichbar
• MIB-Datei im Web-Interface verfügbar

Wichtige Opsview-Verzeichnisse (On-Premises)

/opt/opsview/                                   <-- Opsview Hauptverzeichnis
/opt/opsview/snmptraps/var/load/                <-- MIB-Dateien für SNMP Traps
/usr/share/snmp/mibs/                           <-- MIB-Dateien für SNMP Polling Walk
/opt/opsview/monitoringscripts/notifications/   <-- Notification-Skripte

Zwei Monitoring-Arten in Opsview für Didactum

• SNMP Polling (aktiv): Opsview fragt das Gerät regelmäßig ab – ideal für Temperatur, Luftfeuchtigkeit und Statuswerte
• SNMP Traps (passiv): Das Didactum-Gerät sendet bei Alarm eigenständig eine Meldung an Opsview – sofortige Alarmierung ohne Polling-Verzögerung

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

SNMPv3-Einstellungen (optional, erhöhte Sicherheit)

Einstellungen speichern. SNMP-Verbindung vom Opsview-Server aus testen:

snmpwalk -v 2c -c didactum_opsview 192.168.1.50 .1.3.6.1.4.1.46501

Das Installieren der MIB-Datei ermöglicht Opsview, OID-Nummern in lesbare Namen zu übersetzen und vereinfacht die Auswahl der richtigen OIDs beim SNMP Walk erheblich.

Schritt 1 – MIB-Datei aus dem Didactum Web-Interface laden

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

Schritt 2 – MIB für SNMP Polling Walk installieren

# MIB-Datei auf den Opsview-Server kopieren
sudo cp didactum.mib /usr/share/snmp/mibs/

# SNMP-Konfiguration für MIB-Nutzung
echo "mibdirs /usr/share/snmp/mibs" | sudo tee -a /etc/snmp/snmp.conf
echo "mibs ALL" | sudo tee -a /etc/snmp/snmp.conf

Schritt 3 – MIB für SNMP Traps installieren

# Für SNMP Traps muss die MIB in dieses Verzeichnis:
sudo cp didactum.mib /opt/opsview/snmptraps/var/load/

# snmptrapd Dienst neu starten
sudo systemctl restart opsview-snmptrapd

Schritt 4 – MIB-Installation testen

# Überprüfen ob MIB geladen wird
snmptranslate -m /usr/share/snmp/mibs/didactum.mib \
    .1.3.6.1.4.1.46501.5.1.1.7.101001

# Vollständiger Walk mit MIB-Namen
snmpwalk -v 2c -c didactum_opsview -m ALL 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1

Navigation im Web-Interface

Configuration → Hosts → Add New Host

Schritt 1 – Reiter „Basic" ausfüllen

Schritt 2 – Reiter „Host Templates" zuweisen

Folgendes Host Template hinzufügen:

Auf Add klicken, um die Templates zuzuweisen.

Schritt 3 – Reiter „SNMP" konfigurieren

Bei SNMPv3 zusätzlich:

Schritt 4 – SNMP-Verbindung testen

Auf den Button Test SNMP Connection klicken. Eine grüne Erfolgsmeldung bestätigt die korrekte Verbindung.

Schritt 5 – Host speichern

Auf Submit klicken. Der Host wird gespeichert (aber noch nicht aktiviert – Apply Changes kommt in Abschnitt 11).

Der SNMP Walk zeigt alle verfügbaren OIDs des Didactum-Geräts an und erleichtert die Konfiguration der Service Checks erheblich.

Schritt 1 – SNMP Walk über das Web-Interface starten

Configuration → Service Checks → Add New Service Check
→ Typ: SNMP Polling auswählen
→ Reiter „SNMP Polling"
→ Feld „Example Host": didactum-monitor-01 auswählen
→ Auf „Rescan" klicken

Opsview führt jetzt einen vollständigen SNMP Walk gegen das Didactum-Gerät aus. Die Ergebnisse werden in einer Tabelle angezeigt.

Schritt 2 – SNMP Walk per Kommandozeile (alternativ)

# Auf dem Opsview-Server:
snmpwalk -v 2c -c didactum_opsview 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1 | head -50

# Nur Messwerte (OID .7.x):
snmpwalk -v 2c -c didactum_opsview 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1.7

# Nur Statuswerte (OID .6.x):
snmpwalk -v 2c -c didactum_opsview 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1.6

# Einzelnen Wert direkt abfragen:
snmpget -v 2c -c didactum_opsview 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1.7.101001

Schritt 3 – OID aus SNMP Walk-Tabelle übernehmen

Im Web-Interface: Gewünschte OID in der Ergebnistabelle anklicken. Opsview füllt automatisch die Felder „OID" und „Label" im Service Check aus.

Jeder Service Check überwacht einen bestimmten Sensorwert gegen definierte Schwellwerte.

Navigation

Configuration → Service Checks → Add New Service Check
→ Typ: SNMP Polling

Service Check: Temperatursensor

Reiter „Details" → Basic:

Reiter „SNMP Polling":

Wichtig: Das Didactum-Gerät liefert Temperaturwerte als Rohwert × 10. 25,5 °C = OID-Wert 255. Alle Schwellwerte im Service Check müssen daher ebenfalls × 10 angegeben werden.

Auf Submit klicken.

Service Check: Leckagesensor

Service Check: Temperatursensor-Status

Service Check: Luftfeuchtigkeit

Service Check: Türkontakt

Service Check: Rauchmelder

Ein Host Template bündelt alle Didactum-spezifischen Service Checks. Damit können mehrere Geräte mit einem Klick konfiguriert werden.

Schritt 1 – Host Template anlegen

Configuration → Host Templates → Add New Host Template

Schritt 2 – Service Checks dem Template zuweisen

Im Bereich „Service Checks" alle zuvor erstellten Checks hinzufügen:

• Didactum Temperatur Sensor 01
• Didactum Temp Status Sensor 01
• Didactum Leckage Sensor 01
• Didactum Luftfeuchtigkeit Sensor 01
• Didactum Tuerkonakt 01
• Didactum Rauchmelder 01

Auf Submit klicken.

Schritt 3 – Template dem Didactum-Host zuweisen

Configuration → Hosts → didactum-monitor-01 bearbeiten
→ Reiter "Host Templates"
→ "Didactum Monitoring System" aus der Liste hinzufügen
→ Submit

Schritt 4 – Template für zweites Gerät wiederverwenden

Configuration → Hosts → Add New Host
→ IP: 192.168.1.51
→ Host Name: didactum-monitor-02
→ Host Templates → "Didactum Monitoring System" hinzufügen
→ SNMP Tab → Community: didactum_opsview → Submit

Mit SNMP Traps sendet das Didactum-Gerät bei einem Alarm sofort eine Meldung an Opsview – ohne auf den nächsten Polling-Zyklus warten zu müssen.

Schritt 1 – SNMP Trap Service Check anlegen

Configuration → Service Checks → Add New Service Check
→ Typ: SNMP Trap auswählen

Schritt 2 – Reiter „SNMP Trap" konfigurieren

Auf Submit klicken.

Schritt 3 – Trap-spezifische Regeln für einzelne Sensoren

Für präzisere Trap-Behandlung können mehrere Regeln innerhalb des Service Checks angelegt werden:

Schritt 4 – Trap Service Check dem Host zuweisen

Configuration → Hosts → didactum-monitor-01
→ Host Templates → "Didactum Monitoring System"
→ Service Checks → "Didactum SNMP Trap Alarm" hinzufügen → Submit

Schritt 5 – snmptrapd-Dienst prüfen (On-Premises)

sudo systemctl status opsview-snmptrapd

# Trap-Log einsehen
sudo tail -f /opt/opsview/snmptraps/var/log/snmptrapd.log

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 und Opsview-Schwellwerten

Sensor-ID herausfinden: 

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

Temperaturschwellwerte in Opsview: 

Opsview vergleicht den Rohwert des OID direkt. Da Didactum Temperaturen × 10 überträgt, müssen Schwellwerte ebenfalls × 10 eingegeben werden. Warnung bei 28°C → Wert 280; Kritisch bei 35°C → Wert 350.

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.

Schritt 1 – Notification Method aktivieren

Configuration → Notification Methods

Die E-Mail Notification Method ist standardmäßig vorhanden. Sicherstellen, dass sie aktiviert ist:

Auf Submit klicken.

Schritt 2 – Lokalen Mailversand konfigurieren (On-Premises)

# Postfix installieren
sudo apt install postfix mailutils -y
# Konfigurationstyp: "Satellite system" oder "Internet Site"

# Relay-Host setzen (in /etc/postfix/main.cf):
relayhost = mail.ihredomain.de

# Postfix neu starten
sudo systemctl restart postfix

# Test
echo "Test Opsview" | mail -s "Test" admin@ihredomain.de

Absenderadresse anpassen:

# Domain des Absenders
sudo nano /etc/mailname
# Inhalt: ihredomain.de

# Absender-Adresse in Opsview-Skript prüfen:
sudo nano /opt/opsview/monitoringscripts/notifications/notify_by_email
# Standard-Pfad für mail-Binary: /usr/bin/Mail
# Ggf. auf /usr/bin/mail korrigieren

Schritt 3 – Kontakt anlegen

Configuration → Contacts → Add New Contact

Auf Submit klicken.

Schritt 4 – Notification Profile anlegen

Configuration → Notification Profiles → Add New Notification Profile

Schritt 5 – Kontakt dem Host zuweisen

Configuration → Hosts → didactum-monitor-01 bearbeiten
→ Reiter "Contacts"
→ Administrator hinzufügen → Submit

In Opsview werden alle Konfigurationsänderungen erst nach einem expliziten „Apply Changes" aktiv. Dieser Schritt generiert die Nagios-Konfigurationsdateien und startet den Monitoring-Daemon neu.

Apply Changes über das Web-Interface

Configuration → Apply Changes
→ Auf den Button "Apply Changes" klicken

Opsview zeigt den Fortschritt an. Nach Abschluss erscheint die Meldung „Configuration applied successfully".

Apply Changes per Kommandozeile (On-Premises)

sudo /opt/opsview/bin/opsview-config --apply
# oder:
sudo /opt/opsview/utils/rc.opsview gen_config reload

Wann ist Apply Changes erforderlich?

• Nach dem Hinzufügen eines neuen Hosts
• Nach dem Anlegen oder Ändern von Service Checks
• Nach dem Ändern von Host Templates
• Nach dem Anlegen von Kontakten oder Notification Profiles
• Nach jeder Konfigurationsänderung im Web-Interface

SNMP-Verbindung testen

# Einfacher Verbindungstest
snmpget -v 2c -c didactum_opsview 192.168.1.50 sysDescr.0

# Temperaturwert abfragen (Rohwert ÷ 10 = °C)
snmpget -v 2c -c didactum_opsview 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1.7.101001

# Leckage-Status abfragen
snmpget -v 2c -c didactum_opsview 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1.7.107001

# SNMP-Verbindungstest im Web-Interface:
Configuration → Hosts → didactum-monitor-01 → SNMP Tab
→ "Test SNMP Connection" Button

Service Check-Status prüfen

Monitoring → Service Checks
→ Filter: Host = didactum-monitor-01
→ Status aller Service Checks anzeigen

SNMP Walk im Web-Interface erneut ausführen

Configuration → Service Checks → [Service Check bearbeiten]
→ SNMP Polling Tab → Example Host: didactum-monitor-01
→ "Rescan" klicken

# Nagios Core Log
sudo tail -f /opt/opsview/nagios/var/nagios.log

# Opsview Web Log
sudo tail -f /opt/opsview/var/log/opsview.log

# SNMP Trap Log
sudo tail -f /opt/opsview/snmptraps/var/log/snmptrapd.log

# Systemd Journal
sudo journalctl -u opsview -f --since "1 hour ago"

Didactum-Gerät

• SNMP aktiviert (v2c oder v3)
• Community String gesetzt (nicht „public")
• Gerät ist per Ping vom Opsview-Server erreichbar
• Trap-Empfänger-IP auf Opsview-Server gesetzt
• Trap-Port 162 eingetragen
• MIB-Datei heruntergeladen

Opsview Server

• MIB-Datei unter /usr/share/snmp/mibs/ gespeichert
• MIB-Datei unter /opt/opsview/snmptraps/var/load/ gespeichert (für Traps)
• snmpwalk-Test vom Opsview-Server erfolgreich
• UDP 161 ausgehend und UDP 162 eingehend geöffnet

Opsview Konfiguration

• Host „didactum-monitor-01" mit SNMP-Tab konfiguriert
• SNMP-Verbindungstest erfolgreich (grüne Meldung)
• SNMP Walk erfolgreich ausgeführt (Sensoren sichtbar)
• Service Checks für alle Sensortypen angelegt
• Temperaturschwellwerte × 10 eingegeben
• Host Template „Didactum Monitoring System" angelegt
• Alle Service Checks dem Template zugewiesen
• Template dem Host zugewiesen
• SNMP Trap Service Check angelegt und zugewiesen

Benachrichtigung

• Postfix / Mailversand funktioniert (Test-Mail erhalten)
• Email Notification Method aktiviert
• Kontakt mit E-Mail-Adresse angelegt
• Notification Profile „Didactum Alarm Profil" angelegt
• Kontakt dem Host zugewiesen
• Apply Changes erfolgreich ausgeführt
• Test-Alarm ausgelöst und E-Mail empfangen