Didactum Monitoring & Zyrion Traverse Integration
Vollständige Schritt-für-Schritt-Anleitung zur Einbindung von Didactum Monitoring-Geräten und Sensoren in Zyrion Traverse via SNMP – inklusive Device-Discovery, MIB-Import, Test-Konfiguration für alle Sensortypen (Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch), Schwellwert- und Alarm-Konfiguration, SNMP-Trap-Verarbeitung über den Traverse Trap-Receiver sowie Dashboard- und Report-Einrichtung.
Architektur-Hinweis: Zyrion Traverse arbeitet mit einem Test-basierten Monitoring-Konzept. Jede überwachte Metrik (OID-Abfrage) wird als eigenständiger Test definiert, dem Schwellwerte (Thresholds), Benachrichtigungsprofile und Aktionen direkt zugewiesen werden. Das Didactum-Gerät wird als Device in Traverse angelegt und erhält eine Reihe von SNMP-Tests. Traverse sendet SNMP-GET-Anfragen (UDP-Port 161) an das Didactum-Gerät; SNMP-Traps werden vom Didactum-Gerät aktiv an den Traverse-Server gesendet (UDP-Port 162).
- Software: Zyrion Traverse (aktuelle Version)
- Komponenten: Traverse Web UI, Traverse DGE (Data Gathering Engine), Trap-Receiver
- Protokoll: SNMP v1 / v2c / v3
- Geräte: Didactum Monitoring System 100T / 300T / 500T / 550T
- Sensoren: Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch
1. Voraussetzungen & Systemüberblick
Zyrion Traverse Server
| Komponente | Anforderung / Details |
|---|---|
| Zyrion Traverse Version | Aktuelle Version empfohlen; DGE (Data Gathering Engine) muss aktiv sein |
| Betriebssystem | Linux (RHEL / CentOS / Ubuntu) oder Windows Server |
| DGE (Data Gathering Engine) | Zuständig für SNMP-Polling; muss im gleichen Netzwerksegment wie das Didactum-Gerät erreichbar sein |
| Traverse Trap-Receiver | UDP-Port 162 eingehend am Traverse-Server geöffnet |
| Netzwerk (ausgehend) | UDP-Port 161 vom DGE zum Didactum-Gerät (SNMP-Polling) |
| Netzwerk (eingehend) | UDP-Port 162 vom Didactum-Gerät zum Traverse-Server (SNMP-Traps) |
| MIB-Verzeichnis | Zugänglicher MIB-Pfad auf dem Traverse-Server für den MIB-Import |
| Remote DGE (optional) | Falls Didactum-Gerät in einem anderen Netzwerksegment; Remote-DGE dort einsetzen |
Didactum-Gerät
| Anforderung | Details |
|---|---|
| Modell | Monitoring System 100T, 300T, 500T oder 550T |
| SNMP | SNMP aktiviert (v2c empfohlen) |
| Community String | Individueller Community String (nicht „public" verwenden) |
| Trap-Ziel | IP-Adresse des Zyrion-Traverse-Servers |
| MIB-Datei | Unter Systemeinstellungen → SNMP herunterladbar |
Enterprise OIDs je Firmware-Generation
| Gerät / Firmware | Enterprise OID (Basis) |
|---|---|
| Ältere Modelle / ältere Firmware | .1.3.6.1.4.1.46501 |
| Neuere Modelle / aktuelle Firmware | .1.3.6.1.4.1.39052 |
Hinweis: Welche Enterprise OID Ihr Gerät verwendet, ermitteln Sie per:
snmpwalk -v 2c -c public 192.168.1.50 .1.3.6.1.2.1.1.2.0
2. SNMP auf dem Didactum-Gerät aktivieren
Schritt 1 – Web-Interface öffnen
192.168.1.50 (IP des Didactum-Geräts anpassen)
Schritt 2 – SNMP-Einstellungen aufrufen
Systemeinstellungen → SNMP
Schritt 3 – Folgende Werte eintragen
| Feld im Didactum Web-Interface | Empfohlener Wert |
|---|---|
| SNMP aktivieren | Aktiviert |
| SNMP-Version | v2c (empfohlen) |
| Community String (Read) | didactum_traverse (nicht „public" verwenden!) |
| SNMP-Port | 161 |
| Trap-Ziel (Trap Destination) | IP-Adresse des Zyrion-Traverse-Servers |
| Trap-Community | didactum_trap |
| Trap-Port | 162 |
Schritt 4 – MIB-Datei herunterladen
Systemeinstellungen → SNMP → "MIB-Datei herunterladen" Datei wird als didactum.mib gespeichert. Diese Datei wird in Schritt 3 in Traverse importiert.
Einstellungen speichern. Das Gerät sendet SNMP-Traps ab sofort an den Traverse-Server.
3. MIB-Datei in Zyrion Traverse importieren
Zyrion Traverse verwendet MIB-Dateien zur symbolischen Auflösung von OID-Nummern in der Web-Oberfläche, bei Test-Konfigurationen und in Trap-Ereignissen.
Schritt 1 – MIB-Verzeichnis ermitteln
Standard-Pfad auf Linux: /usr/local/traverse/mibs/ /opt/traverse/mibs/ Standard-Pfad auf Windows: C:\Program Files\Zyrion\Traverse\mibs\ (Exakter Pfad je nach Installation; in der Traverse-Konfigurationsdatei traverse.cfg unter dem Parameter mib_path nachschlagen)
Schritt 2 – MIB-Datei kopieren
didactum.mib in das Traverse-MIB-Verzeichnis kopieren:
Linux:
cp didactum.mib /usr/local/traverse/mibs/
Windows:
copy didactum.mib "C:\Program Files\Zyrion\Traverse\mibs\"Schritt 3 – MIB über die Traverse Web-Oberfläche laden
Zyrion Traverse Web UI → Administration → MIB Management → Load MIB → Alternativ: Administration → SNMP → MIB Browser → Import → Datei didactum.mib aus dem MIB-Verzeichnis auswählen → "Load" / "Import" klicken → Erfolgsmeldung: "DIDACTUM-MIB loaded successfully" → Im MIB-Baum erscheint: enterprises → didactum (.1.3.6.1.4.1.46501)
Schritt 4 – MIB-Import verifizieren
Traverse Web UI → Administration → MIB Browser → OID eingeben: .1.3.6.1.4.1.46501.5.1.1.7.101001 → Erwartetes Ergebnis: DIDACTUM-MIB::sensorValue.101001 → Symbolischer Name wird korrekt aufgelöst
Fertige MIB-Importkonfiguration (DIDACTUM-MIB.txt)
Falls keine MIB-Datei aus dem Gerät verfügbar ist, folgende minimale MIB-Struktur als DIDACTUM-MIB.txt in das Traverse-MIB-Verzeichnis kopieren und wie oben importieren:
-- ================================================================
-- DIDACTUM-MIB – Minimale MIB für Zyrion Traverse Import
-- Datei: DIDACTUM-MIB.txt
-- Für ältere Geräte: enterprises.46501
-- Für neuere Geräte: enterprises.39052 (OID anpassen)
-- ================================================================
DIDACTUM-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, Integer32, enterprises
FROM SNMPv2-SMI
NOTIFICATION-TYPE
FROM SNMPv2-SMI;
didactum MODULE-IDENTITY
LAST-UPDATED "202401010000Z"
ORGANIZATION "Didactum Security GmbH"
CONTACT-INFO "support@didactum-security.com"
DESCRIPTION "Didactum Monitoring System MIB"
::= { enterprises 46501 }
sensorTable OBJECT-TYPE
SYNTAX SEQUENCE OF SensorEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Tabelle aller angeschlossenen Sensoren"
::= { didactum 5 1 1 }
sensorEntry OBJECT-TYPE
SYNTAX SensorEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Einzelner Sensor-Eintrag"
INDEX { sensorIndex }
::= { sensorTable 1 }
SensorEntry ::= SEQUENCE {
sensorIndex Integer32,
sensorID Integer32,
sensorType Integer32,
sensorName OCTET STRING,
sensorStatus Integer32,
sensorValue Integer32
}
sensorIndex OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current
DESCRIPTION "Index" ::= { sensorEntry 1 }
sensorID OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current
DESCRIPTION "Sensor ID" ::= { sensorEntry 2 }
sensorType OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current
DESCRIPTION "Sensor-Typ" ::= { sensorEntry 3 }
sensorName OBJECT-TYPE SYNTAX OCTET STRING MAX-ACCESS read-only STATUS current
DESCRIPTION "Sensor-Name" ::= { sensorEntry 5 }
sensorStatus OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current
DESCRIPTION "0=OK 1=Alarm 2=Kein Signal" ::= { sensorEntry 6 }
sensorValue OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current
DESCRIPTION "Messwert (Temperatur: x10)" ::= { sensorEntry 7 }
didactumAlarmTrap NOTIFICATION-TYPE
OBJECTS { sensorName, sensorStatus, sensorValue }
STATUS current
DESCRIPTION "Alarm-Trap bei Sensor-Statusänderung"
::= { didactum 1 1 }
END
4. Didactum-Gerät in Zyrion Traverse anlegen
Variante A – Automatische Device Discovery
Schritt 1 – Discovery-Job anlegen
Traverse Web UI → Devices → Discovery → New Discovery Discovery Name: Didactum-Discovery IP Range: 192.168.1.50 – 192.168.1.50 DGE: Lokaler DGE (oder Remote-DGE im Netzwerksegment des Geräts) SNMP Version: v2c Community String: didactum_traverse SNMP Port: 161 Timeout: 5 Sekunden Retries: 3 → "Start Discovery" klicken
Schritt 2 – Discovery-Ergebnis prüfen und Gerät übernehmen
→ Gerät erscheint in der Ergebnisliste:
Name: Didactum Monitoring System (aus sysName)
IP: 192.168.1.50
SNMP: Reachable
→ "Add to Monitoring" klicken
→ Container auswählen: Environmental / Serverraum
→ Gerät wird der Traverse-Geräteliste hinzugefügtVariante B – Manuelles Anlegen
Traverse Web UI → Devices → Add Device Device Name: Didactum-Monitor-01 IP Address: 192.168.1.50 Device Type: SNMP Device Container: /Environmental/Serverraum (neu anlegen falls nicht vorhanden) DGE: Lokaler DGE oder Remote-DGE SNMP Version: v2c Community String: didactum_traverse SNMP Port: 161 Timeout: 5 Sekunden Retries: 3 Description: Didactum Monitoring System 300T – Serverraum → Speichern
Schritt 3 – SNMP-Verbindung testen
Traverse Web UI → Devices → Didactum-Monitor-01 → Test SNMP Connectivity → Erwartetes Ergebnis: "SNMP connection successful" → sysDescr: Didactum Monitoring System → sysUpTime erscheint Falls Test fehlschlägt: → Community String und IP-Adresse prüfen → Firewall UDP 161 vom DGE zum Didactum-Gerät prüfen → snmpwalk direkt vom DGE-Server aus testen (siehe Abschnitt 10)
5. SNMP-Tests für Didactum-Sensoren konfigurieren
In Zyrion Traverse wird jede überwachte Metrik als eigenständiger Test definiert. Für das Didactum-Gerät werden SNMP-Tests für alle Sensor-OIDs angelegt. Jeder Test erhält eigene Schwellwerte (Warning / Critical), ein Polling-Intervall und ein Benachrichtigungsprofil.
Wichtig – Temperaturschwellwerte: Das Didactum-Gerät liefert Temperaturwerte als Rohwert × 10. 25,5 °C = OID-Wert 255. Alle Temperaturschwellen in Traverse-Tests müssen ebenfalls × 10 angegeben werden.
SNMP-Tests anlegen
Traverse Web UI → Devices → Didactum-Monitor-01 → Tests → Add Test → SNMP OID
-- ================================================================
-- Test 1: Temperatursensor Messwert (Sensor-ID 101001)
-- ================================================================
Test Name: Temperatur_Sensor_01
Test Type: SNMP OID
OID: .1.3.6.1.4.1.46501.5.1.1.7.101001
Data Type: Integer / Gauge
Poll Interval: 60 Sekunden
Description: Temperatursensor 01 – Rohwert x10; 235 = 23,5 Grad C
Container: /Environmental/Serverraum/Didactum-Monitor-01
Thresholds:
Warning High: 280 (= 28,0 Grad C)
Critical High: 350 (= 35,0 Grad C)
Warning Low: (leer)
Critical Low: (leer)
Alarm Message: Didactum Temp-Alarm: Rohwert ${value} (= ${value/10} Grad C)
Recovery Message: Didactum Temperatur wieder normal: Rohwert ${value}
Notification: Didactum-Alarm-Profil (in Schritt 8 anlegen)
→ Speichern
-- ================================================================
-- Test 2: Temperatursensor Status (0=OK / 1=Alarm / 2=Kein Signal)
-- ================================================================
Test Name: Temperatur_Status_01
OID: .1.3.6.1.4.1.46501.5.1.1.6.101001
Data Type: Integer
Poll Interval: 60 Sekunden
Thresholds:
Warning High: 1
Critical High: 2
Alarm Message: Didactum Temp-Status: ${value} (0=OK, 1=Alarm, 2=Kein Signal)
→ Speichern
-- ================================================================
-- Test 3: Wassersensor / Leckage (Sensor-ID 107001)
-- ================================================================
Test Name: Leckage_Sensor_01
OID: .1.3.6.1.4.1.46501.5.1.1.7.107001
Data Type: Integer
Poll Interval: 30 Sekunden
Thresholds:
Critical High: 1 (0 = trocken / OK, 1 = Wasser erkannt / CRITICAL)
Alarm Message: KRITISCH: Didactum Leckage-Alarm – Wasser erkannt! Gerät: ${device}
Recovery Message: Didactum Leckage: Kein Wasser mehr erkannt
→ Speichern
-- ================================================================
-- Test 4: Luftfeuchtigkeit (Sensor-ID 102001)
-- ================================================================
Test Name: Luftfeuchtigkeit_Sensor_01
OID: .1.3.6.1.4.1.46501.5.1.1.7.102001
Data Type: Integer / Gauge
Poll Interval: 60 Sekunden
Unit: %
Thresholds:
Warning High: 80
Critical High: 90
Alarm Message: Didactum Luftfeuchtigkeit-Alarm: ${value} %
Recovery Message: Didactum Luftfeuchtigkeit wieder normal: ${value} %
→ Speichern
-- ================================================================
-- Test 5: Türkontakt (Sensor-ID 104001)
-- ================================================================
Test Name: Tuerkontakt_01
OID: .1.3.6.1.4.1.46501.5.1.1.7.104001
Data Type: Integer
Poll Interval: 30 Sekunden
Thresholds:
Warning High: 1 (0 = geschlossen / OK, 1 = geöffnet / Warning)
Alarm Message: Didactum Türkontakt: Tür geöffnet – Gerät: ${device}
Recovery Message: Didactum Türkontakt: Tür wieder geschlossen
→ Speichern
-- ================================================================
-- Test 6: Rauchmelder (Sensor-ID 106001)
-- ================================================================
Test Name: Rauchmelder_01
OID: .1.3.6.1.4.1.46501.5.1.1.7.106001
Data Type: Integer
Poll Interval: 30 Sekunden
Thresholds:
Critical High: 1 (0 = kein Rauch / OK, 1 = Alarm / CRITICAL)
Alarm Message: KRITISCH: Didactum Rauchmelder-Alarm! Gerät: ${device}
Recovery Message: Didactum Rauchmelder: Kein Rauch mehr erkannt
→ SpeichernAlle Tests aktivieren
Traverse Web UI → Devices → Didactum-Monitor-01 → Tests
→ Alle Tests auf "Enabled" setzen
→ Nach dem ersten Poll-Intervall erscheinen Messwerte unter:
Devices → Didactum-Monitor-01 → Test Results / Performance6. Test-Gruppen und Container konfigurieren
Zyrion Traverse organisiert Geräte und Tests in Containern (hierarchische Gruppen). Für eine übersichtliche Struktur wird ein eigener Container für das Didactum-Gerät angelegt.
Traverse Web UI → Containers → New Container
Container Name: Serverraum-Monitoring
Parent: /Environmental (oder Root)
Description: Didactum Umweltsensoren Serverraum
Icon: Server Room / Environmental
→ Speichern
Traverse Web UI → Devices → Didactum-Monitor-01 → Move to Container
→ Container: /Environmental/Serverraum-Monitoring
→ Speichern
Traverse Web UI → Containers → Serverraum-Monitoring → Test Groups
→ New Test Group: Didactum-Temperatursensoren
Tests: Temperatur_Sensor_01, Temperatur_Status_01
→ New Test Group: Didactum-Umweltsensoren
Tests: Leckage_Sensor_01, Luftfeuchtigkeit_Sensor_01,
Tuerkontakt_01, Rauchmelder_01
→ Speichern7. SNMP-Trap-Empfang konfigurieren
Der Traverse Trap-Receiver empfängt eingehende SNMP-Traps vom Didactum-Gerät und wandelt sie in Traverse-Alarme um. Dadurch wird bei einem Sensor-Alarm sofort ein Ereignis in Traverse erzeugt – unabhängig vom Polling-Intervall.
Schritt 1 – Trap-Receiver aktivieren
Traverse Web UI → Administration → SNMP Trap Receiver Listen Port: 162 Community: didactum_trap SNMP Version: v2c MIB: DIDACTUM-MIB (zuvor importiert) → "Enable Trap Receiver" aktivieren → Speichern → Traverse-Trap-Dienst neu starten falls erforderlich
Schritt 2 – Trap-Quelle autorisieren
Traverse Web UI → Administration → SNMP Trap Receiver → Allowed Sources → Add Source → IP-Adresse: 192.168.1.50 (Didactum-Gerät) → Community: didactum_trap → Device: Didactum-Monitor-01 (aus Geräteliste zuweisen) → Speichern
Schritt 3 – Trap-Definitionen und Mappings anlegen
Traverse Web UI → Administration → SNMP Trap Definitions → New Definition
-- Trap-Definition 1: Allgemeiner Alarm-Trap --
Definition Name: Didactum_Alarm_Trap
Trap OID: .1.3.6.1.4.1.46501.1.1 (didactumAlarmTrap)
Source IP: 192.168.1.50
Community: didactum_trap
Severity: Critical
Container: /Environmental/Serverraum-Monitoring
Alarm Message: Didactum Trap-Alarm: ${varbind[sensorName]} –
Status ${varbind[sensorStatus]} –
Wert ${varbind[sensorValue]}
Action: Create Alarm + Send Notification
→ Speichern
-- Trap-Definition 2: Entwarnung --
Definition Name: Didactum_Clear_Trap
Trap OID: .1.3.6.1.4.1.46501.1.2
Severity: Informational
Alarm Message: Didactum: ${varbind[sensorName]} – Zustand wieder normal
Action: Clear Alarm + Send Notification
→ Speichern
-- Trap-Definition 3: Neuere Geräte (Enterprise OID 39052) --
Definition Name: Didactum_Alarm_Trap_39052
Trap OID: .1.3.6.1.4.1.39052.1.1
Severity: Critical
Alarm Message: Didactum (39052) Trap-Alarm: ${varbind[sensorName]}
→ SpeichernSchritt 4 – Trap-Weiterleitung im Didactum Web-Interface prüfen
Didactum Web-Interface → Systemeinstellungen → SNMP → Trap-Ziele Trap Destination: 192.168.1.100 (IP des Zyrion-Traverse-Servers) Trap Community: didactum_trap Trap Version: v2c Trap Port: 162 → Speichern
8. Benachrichtigungsprofile (Notification Profiles) konfigurieren
Zyrion Traverse verwendet Notification Profiles, die einem oder mehreren Tests direkt zugewiesen werden. Das Profil legt fest, wer bei welchen Ereignissen (Warning / Critical / Recovery) benachrichtigt wird.
Schritt 1 – Benachrichtigungsprofil anlegen
Traverse Web UI → Administration → Notification Profiles → New Profile
Profile Name: Didactum-Alarm-Profil
Description: Benachrichtigungen für Didactum Sensor-Alarme
Notification bei: Warning, Critical, Unknown
Erneut bei: Alle 15 Minuten (solange Alarm aktiv)
Recovery: Ja (Benachrichtigung bei Alarm-Aufhebung)
Method 1 – E-Mail:
To: admin@ihredomain.de
Subject: [Traverse] Didactum Alarm: ${device} – ${test} – ${severity}
Body:
Zeitpunkt: ${alert_time}
Gerät: ${device} (${device_ip})
Test: ${test}
Container: ${container}
Schwere: ${severity}
Wert: ${current_value}
Schwellwert: ${threshold}
Meldung: ${message}
→ SpeichernSchritt 2 – Eskalations-Stufen konfigurieren
Traverse Web UI → Administration → Notification Profiles
→ Didactum-Alarm-Profil → Escalation
Stufe 1 – Sofort (0 Minuten):
Methode: E-Mail an admin@ihredomain.de
Bedingung: Warning oder Critical
Stufe 2 – Nach 5 Minuten (Alarm noch aktiv):
Methode: E-Mail an it-leitung@ihredomain.de
Bedingung: Critical
Stufe 3 – Nach 15 Minuten (Alarm noch aktiv):
Methode: SNMP-Trap-Forward oder Skript
Bedingung: Critical
→ SpeichernSchritt 3 – Profil allen Didactum-Tests zuweisen
Traverse Web UI → Devices → Didactum-Monitor-01 → Tests Für jeden Test (Temperatur_Sensor_01, Leckage_Sensor_01 usw.): → Test öffnen → Notification Profile: "Didactum-Alarm-Profil" → Speichern Alternativ: Batch-Zuweisung über Container: Containers → Serverraum-Monitoring → Apply Notification Profile → Profil: Didactum-Alarm-Profil → Auf alle Tests im Container anwenden → Speichern
9. Dashboard und Reports konfigurieren
Schritt 1 – Dashboard anlegen
Traverse Web UI → Dashboards → New Dashboard Dashboard Name: Serverraum-Monitoring Didactum Layout: Grid 2 x 3
Schritt 2 – Dashboard-Widgets konfigurieren
Widget 1: Temperatur-Trend (Performance Chart) Typ: Performance Graph / Time Series Device: Didactum-Monitor-01 Test: Temperatur_Sensor_01 Zeitraum: Letzte 24 Stunden Y-Achse: Rohwert (÷10 = Grad C) Threshold: Warning-Linie 280 / Critical-Linie 350 Widget 2: Leckage-Status (Current Value) Typ: Current Value / Status LED Test: Leckage_Sensor_01 OK-Farbe: Grün (Wert = 0) Alarm-Farbe: Rot (Wert = 1) Widget 3: Luftfeuchtigkeit (Gauge) Typ: Gauge / Dial Test: Luftfeuchtigkeit_Sensor_01 Min / Max: 0 / 100 % Warning: 80 % Critical: 90 % Widget 4: Türkontakt-Status (Current Value) Typ: Current Value / Status LED Test: Tuerkontakt_01 OK-Farbe: Grün (Wert = 0) Alarm-Farbe: Gelb (Wert = 1) Widget 5: Rauchmelder-Status (Current Value) Typ: Current Value / Status LED Test: Rauchmelder_01 OK-Farbe: Grün (Wert = 0) Alarm-Farbe: Rot (Wert = 1) Widget 6: Aktive Alarme (Alarm Summary) Typ: Alarm List / Alert Summary Filter: Container = /Environmental/Serverraum-Monitoring Zeigt: Alle aktiven Alarme in Echtzeit
Schritt 3 – Container-Status-Ansicht nutzen
Traverse Web UI → Containers → Serverraum-Monitoring → Zeigt Gesamtstatus aller Tests im Container → Farbkodierung: Grün (OK) / Gelb (Warning) / Rot (Critical) / Grau (Unknown) → Drill-Down: Klick auf Gerät → alle Test-Ergebnisse mit aktuellem Wert
Schritt 4 – Automatisierten Report anlegen
Traverse Web UI → Reports → New Report
Report Name: Didactum Serverraum – Wochenbericht
Container: /Environmental/Serverraum-Monitoring
Tests: Alle Didactum-Tests
Inhalt:
- Temperatur-Trend 7 Tage (Min / Max / Durchschnitt)
- Luftfeuchtigkeit-Trend 7 Tage
- Alarm-Zusammenfassung: alle Didactum-Alarme der Woche
- Test-Verfügbarkeit (% Zeit im OK-Zustand)
Zeitplan: Wöchentlich, Montag 07:00 Uhr
Empfänger: admin@ihredomain.de
Format: PDF
→ Speichern10. SNMP OID-Referenz für Didactum-Sensoren
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
| Feld | OID-Suffix | Bedeutung | Beispiel (Sensor 101001) |
|---|---|---|---|
| Sensor-Index | .5.1.1.1.SENSOR_ID | Interner Index | .1.3.6.1.4.1.46501.5.1.1.1.101001 |
| Sensor-ID | .5.1.1.2.SENSOR_ID | Numerische Sensor-ID | .1.3.6.1.4.1.46501.5.1.1.2.101001 |
| Sensor-Typ | .5.1.1.3.SENSOR_ID | Typ-Kennziffer | .1.3.6.1.4.1.46501.5.1.1.3.101001 |
| Sensor-Name | .5.1.1.5.SENSOR_ID | Bezeichnung (String) | .1.3.6.1.4.1.46501.5.1.1.5.101001 |
| Sensor-Status | .5.1.1.6.SENSOR_ID | 0=OK, 1=Alarm, 2=Kein Signal | .1.3.6.1.4.1.46501.5.1.1.6.101001 |
| Sensor-Messwert | .5.1.1.7.SENSOR_ID | Aktueller Messwert | .1.3.6.1.4.1.46501.5.1.1.7.101001 |
Sensortypen mit vollständigen OIDs und Traverse-Schwellwerten
| Sensortyp | Sensor-ID | OID Messwert | OID Status | Traverse Threshold |
|---|---|---|---|---|
| Temperatursensor (digital) | 101001 | .1.3.6.1.4.1.46501.5.1.1.7.101001 | .1.3.6.1.4.1.46501.5.1.1.6.101001 | Warning High 280 / Critical High 350 (Rohwert × 10) |
| Temperatursensor (analog) | 201001 | .1.3.6.1.4.1.39052.5.2.1.7.201001 | .1.3.6.1.4.1.39052.5.2.1.6.201001 | Warning High 280 / Critical High 350 (× 10) |
| Wassersensor / Leckage | 107001 | .1.3.6.1.4.1.46501.5.1.1.7.107001 | .1.3.6.1.4.1.46501.5.1.1.6.107001 | Critical High 1 (0 = trocken / OK) |
| Luftfeuchtigkeit | 102001 | .1.3.6.1.4.1.46501.5.1.1.7.102001 | .1.3.6.1.4.1.46501.5.1.1.6.102001 | Warning High 80 / Critical High 90 (direkt %) |
| Potentialfreier Kontakt | 101003 | .1.3.6.1.4.1.39052.5.1.1.7.101003 | .1.3.6.1.4.1.39052.5.1.1.6.101003 | Warning High 1 (0 = offen / inaktiv) |
| Türkontakt | 104001 | .1.3.6.1.4.1.46501.5.1.1.7.104001 | .1.3.6.1.4.1.46501.5.1.1.6.104001 | Warning High 1 (0 = geschlossen / OK) |
| Rauchmelder | 106001 | .1.3.6.1.4.1.46501.5.1.1.7.106001 | .1.3.6.1.4.1.46501.5.1.1.6.106001 | Critical High 1 (0 = kein Rauch / OK) |
Sensor-ID ermitteln: Im Didactum Web-Interface unter Systembaum → Sensor auswählen → Details. Die angezeigte Sensor-ID wird als letztes Element an die OID angehängt. Bei mehreren gleichartigen Sensoren erhöht sich die letzte Stelle: 101001, 101002, 101003 usw.
Temperaturschwellwerte in Traverse: Didactum liefert Temperatur als Rohwert × 10. 28,0 °C = OID-Wert 280. Traverse-Test-Schwellwerte (Warning/Critical High) ebenfalls als × 10-Wert eintragen. In Alarm-Messages und Dashboard-Labels auf „÷10 = °C" hinweisen.
11. SNMP-Verbindung testen
Test per Kommandozeile (vom Traverse-Server oder DGE aus)
# snmpwalk – alle Sensor-Werte auflisten
snmpwalk -v 2c -c didactum_traverse 192.168.1.50 \
.1.3.6.1.4.1.46501.5.1.1
# snmpget – Temperaturwert abfragen (Rohwert ÷ 10 = °C)
snmpget -v 2c -c didactum_traverse 192.168.1.50 \
.1.3.6.1.4.1.46501.5.1.1.7.101001
# Erwartete Ausgabe: INTEGER: 235 (= 23,5 °C)
# snmpget – Leckage-Status abfragen
snmpget -v 2c -c didactum_traverse 192.168.1.50 \
.1.3.6.1.4.1.46501.5.1.1.7.107001
# Erwartete Ausgabe (trocken): INTEGER: 0
# snmpget – Sensor-Status abfragen
snmpget -v 2c -c didactum_traverse 192.168.1.50 \
.1.3.6.1.4.1.46501.5.1.1.6.101001
# Erwartete Ausgabe (OK): INTEGER: 0
# Test mit MIB-Namen (nach MIB-Import)
snmpwalk -v 2c -c didactum_traverse -m ALL 192.168.1.50 \
DIDACTUM-MIB::sensorValue
Test über Traverse MIB-Browser
Traverse Web UI → Administration → MIB Browser Host: 192.168.1.50 Community: didactum_traverse Version: v2c OID: .1.3.6.1.4.1.46501.5.1.1.7.101001 → "Get" klicken → Rohwert erscheint (z. B. 235 = 23,5 °C) MIB Browser → Walk → OID: .1.3.6.1.4.1.46501.5.1.1 → Alle Sensor-OIDs und Rohwerte werden aufgelistet
Test-Ergebnisse prüfen
Traverse Web UI → Devices → Didactum-Monitor-01 → Tests → Alle Tests mit Status "OK" und aktuellem Wert erscheinen → Letzter Poll-Zeitstempel wird angezeigt Traverse Web UI → Containers → Serverraum-Monitoring → Gesamtstatus: Alle Ampeln grün (Normalbetrieb)
Trap-Empfang testen
Im Didactum Web-Interface Test-Trap auslösen: Systemeinstellungen → SNMP → "Test Trap senden" In Traverse prüfen: → Traverse Web UI → Alarms → Active Alarms → Neuer Alarm mit Device 192.168.1.50 erscheint → Severity: Critical → Message: Didactum Trap-Alarm: … → E-Mail von Notification-Profil empfangen
12. Fehlersuche und Lösungen
| Problem | Ursache & Lösung |
|---|---|
| Discovery findet Gerät nicht | SNMP auf dem Didactum-Gerät nicht aktiviert; Community String falsch; UDP-Port 161 durch Firewall zwischen DGE und Gerät blockiert → snmpwalk direkt vom DGE aus testen; Community String abgleichen |
| MIB-Import schlägt fehl | Abhängige MIBs fehlen (SNMPv2-SMI, RFC1213-MIB) → Basis-MIBs zuerst in das Traverse-MIB-Verzeichnis kopieren; alternativ DIDACTUM-MIB.txt aus Abschnitt 3 verwenden |
| OID liefert „No Such Object" | Falsche Enterprise OID (46501 vs. 39052) → sysObjectID per snmpwalk prüfen: snmpwalk -v 2c -c COMMUNITY IP .1.3.6.1.2.1.1.2.0 |
| Temperaturwert erscheint 10× zu hoch | Kein Fehler – Didactum liefert Rohwert × 10. Traverse-Test-Schwellwerte als × 10-Wert setzen (28 °C = Warning High 280). Dashboard-Label auf ÷10 = °C anpassen. |
| Test zeigt keinen Wert nach Poll-Intervall | DGE nicht erreichbar oder nicht aktiv; Test nicht aktiviert; OID-Eingabe auf Tippfehler prüfen → DGE-Status in Traverse Administration prüfen; snmpget vom DGE direkt testen |
| SNMP-Traps kommen nicht an | Trap-Ziel-IP im Didactum-Gerät zeigt nicht auf den Traverse-Server; UDP-Port 162 durch Firewall blockiert; Trap-Community stimmt nicht überein; Trap-Receiver nicht aktiviert → Traverse Trap-Receiver-Log prüfen |
| Trap empfangen, aber kein Alarm erzeugt | Trap-Definition fehlt oder Trap-OID stimmt nicht überein; Didactum-IP nicht in Allowed Sources → Trap-Definitionen und Allowed Sources in Administration prüfen |
| Keine E-Mail bei Alarm | SMTP-Einstellungen in Traverse nicht konfiguriert; Notification-Profil dem Test nicht zugewiesen; Eskalations-Policy nicht aktiv → Administration → SMTP Settings prüfen; Test → Notification Profile prüfen |
| Sensor-Wert bleibt immer 0 (Leckage / Türkontakt / Rauch) | Normal bei unkritischem Zustand (0 = OK). Sensor durch kurzes Auslösen testen; OID per snmpget direkt vom DGE aus verifizieren. |
| DGE erreicht Gerät nicht (Remote-DGE) | Remote-DGE nicht im gleichen Netzwerksegment wie das Didactum-Gerät; Routing-Problem → Test dem richtigen DGE zuweisen; Netzwerkroute prüfen; ggf. Remote-DGE im Segment des Didactum-Geräts installieren |
| Test-Status bleibt „Unknown" | Erster Poll noch nicht durchgeführt; DGE-Verbindung unterbrochen; SNMP-Timeout zu kurz → Poll-Interval abwarten; Timeout von 5 auf 10 Sekunden erhöhen; DGE-Status prüfen |
13. Abschluss-Checkliste
Didactum-Gerät
- SNMP aktiviert (v2c)
- Community String gesetzt (nicht „public"): didactum_traverse
- Trap-Ziel auf IP des Zyrion-Traverse-Servers gesetzt
- Trap-Community gesetzt: didactum_trap
- MIB-Datei heruntergeladen (didactum.mib)
- snmpwalk vom Traverse-Server / DGE erfolgreich
Zyrion Traverse Server
- DIDACTUM-MIB in Traverse-MIB-Verzeichnis kopiert und importiert
- MIB-Auflösung im MIB-Browser verifiziert
- Container /Environmental/Serverraum-Monitoring angelegt
- Didactum-Gerät per Discovery gefunden oder manuell angelegt
- Gerät dem Container Serverraum-Monitoring zugewiesen
- SNMP-Verbindungstest erfolgreich
- Alle 6 SNMP-Tests angelegt (Temperatur, Temp-Status, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch)
- Temperaturschwellen als Rohwert × 10 gesetzt (Warning High 280 / Critical High 350)
- Leckage- und Rauchmelder-Critical-Schwelle auf 1 gesetzt
- Test-Gruppen angelegt (Temperatursensoren / Umweltsensoren)
- SNMP-Trap-Receiver aktiviert (Port 162)
- Didactum-IP in Allowed Trap Sources eingetragen
- Trap-Definitionen für Didactum-Alarm-Traps angelegt (46501 und 39052)
- Notification-Profil „Didactum-Alarm-Profil" angelegt
- Profil allen 6 Tests zugewiesen
- SMTP-Einstellungen in Traverse konfiguriert
Tests & Verifizierung
- Alle Tests zeigen Status OK und aktuellen Wert nach erstem Poll-Intervall
- Container-Status: Serverraum-Monitoring zeigt grün (Normalbetrieb)
- Dashboard „Serverraum-Monitoring Didactum" mit allen Widgets konfiguriert
- Temperatur-Trend-Graph zeigt historische Messwerte
- Test-Trap über Didactum Web-Interface ausgelöst → Alarm in Traverse erscheint
- E-Mail vom Notification-Profil bei Test-Alarm empfangen
- Wochenbericht-Report geplant und Test-Export erfolgreich erstellt
- Recovery getestet: Sensor kehrt in OK-Zustand zurück → Alarm aufgehoben, Recovery-Mail empfangen