Didactum in PRTG integrieren – Schritt-für-Schritt
Voraussetzungen
Didactum Monitoring-Geräte sind spezialisierte Rack-Monitoring-Einheiten, die Umgebungsparameter wie Temperatur, Luftfeuchtigkeit, Spannung, Leckage und Türkontakte über SNMP bereitstellen. Diese Anleitung beschreibt die vollständige Integration in Paessler PRTG Network Monitor.
Benötigt werden:
- PRTG Network Monitor (Version 22.x oder neuer) mit Administrator-Zugriff
- Didactum Monitoring-Gerät (z.Bsp. Rack Monitoring) im Netzwerk erreichbar
- SNMP auf dem Didactum-Gerät aktiviert (Standard: SNMP v2c)
- Netzwerkkommunikation: UDP Port 161 (SNMP) vom PRTG-Probe zum Didactum-Gerät freigegeben
- SNMP-Community-String bekannt (Standard: public)
- MIB-Datei des Didactum-Geräts (vom Hersteller oder Gerät abrufbar)
1. SNMP über das Web-Interface aktivieren
- Web-Interface aufrufen: Browser öffnen und IP-Adresse des Didactum-Geräts eingeben (z. B. 192.168.1.100). Standard-Login: admin / admin.
- Netzwerk-/SNMP-Einstellungen öffnen: Navigation: Einstellungen → Netzwerk → SNMP (oder: Settings → Network → SNMP)
- SNMP aktivieren und konfigurieren:
- SNMP aktiviert: Ja / Enable
- SNMP-Version: v2c (empfohlen) oder v3 für erhöhte Sicherheit
- Community-String (v2c): public (oder eigener String, z.Bsp. didactum_monitor)
- SNMP-Port: 161 (Standard, UDP)
- Allowed Managers: IP-Adresse des PRTG-Servers eintragen (Sicherheit)
- Trap-Empfänger konfigurieren (optional): SNMP Trap Receiver: IP des PRTG-Servers, Port 162 (UDP). Dies ermöglicht proaktive Alarmmeldungen vom Gerät an PRTG.
- Einstellungen speichern und Gerät ggf. neu starten. Bei manchen Modellen ist ein Neustart erforderlich, damit SNMP aktiv wird.
Hinweis: SNMP v3 bietet Authentifizierung und Verschlüsselung. Empfohlen für produktive Umgebungen. Protokoll: SHA, Verschlüsselung: AES128.
Achtung: Den Standard-Community-String public in Produktivumgebungen unbedingt ändern, um unbefugten SNMP-Zugriff zu verhindern.
2. SNMP-Konnektivität testen
Vor der PRTG-Konfiguration die SNMP-Erreichbarkeit vom PRTG-Probe-Server testen:
# Unter Linux / von einem Linux-System:
snmpwalk -v2c -c public 192.168.1.100 # Spezifische OID abfragen (System-Beschreibung):
snmpget -v2c -c public 192.168.1.100 1.3.6.1.2.1.1.1.0 Windows: PRTG-eigenen SNMP-Tester verwenden:
Auf der Paessler Seite:
Setup → Downloads → PRTG Tools → SNMP Tester
3. MIB-Datei in PRTG importieren
Durch den Import der Didactum-MIB-Datei kann PRTG OID-Nummern automatisch in lesbare Namen übersetzen und ermöglicht den komfortablen SNMP-MIB-Import-Sensor.
3.1 MIB-Datei beschaffen
3.2 MIB-Datei in PRTG einspielen
- MIB-Datei auf den PRTG-Core-Server kopieren:
- Windows: C:\Program Files (x86)\PRTG Network Monitor\snmpmibs\
- Linux-Probe: /usr/local/prtg/snmpmibs/
- PRTG Web-Interface öffnen: Als Administrator anmelden.
- MIB-Datei hochladen (ab PRTG 22.x): Navigation: Setup → System Administration → SNMP MIBs → MIB-Datei hochladen. Schaltfläche „Upload MIB File" → .mib-Datei auswählen → Bestätigen.
- PRTG-Dienste neu starten: Setup → System Administration → Restart Core Server, damit die MIB geladen wird.
- MIB-Import verifizieren: Beim Anlegen eines „SNMP Custom Table"-Sensors prüfen, ob die Didactum-OIDs mit Klarnamen angezeigt werden.
3.3 MIB-Konfigurationsreferenz (wichtigste OID-Bereiche)
-- DIDACTUM-RACKMONI2-MIB Konfigurationsreferenz
-- OID-Wurzel: 1.3.6.1.4.1.3854 (Didactum Enterprise OID)
-- Systeminfo:
sysDescr 1.3.6.1.2.1.1.1.0 -- Gerätebeschreibung
sysName 1.3.6.1.2.1.1.5.0 -- Gerätename
sysUpTime 1.3.6.1.2.1.1.3.0 -- Betriebszeit (Hundertstelsekunden)
-- Temperatursensoren (Sensor 1–8, {n} = Sensorindex):
tempValue 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.{n} -- Wert × 10
tempStatus 1.3.6.1.4.1.3854.1.2.2.1.16.1.4.{n} -- 0=OK, 1=Warn, 2=Alarm
tempHighAlarm 1.3.6.1.4.1.3854.1.2.2.1.16.1.7.{n} -- Oberer Grenzwert
tempLowAlarm 1.3.6.1.4.1.3854.1.2.2.1.16.1.8.{n} -- Unterer Grenzwert
-- Leckagesensoren:
leakStatus 1.3.6.1.4.1.3854.1.2.2.1.18.1.4.{n} -- 0=OK, 1=Leckage
leakName 1.3.6.1.4.1.3854.1.2.2.1.18.1.2.{n} -- Sensorname
-- Luftfeuchtigkeitssensoren:
humValue 1.3.6.1.4.1.3854.1.2.2.1.17.1.3.{n} -- Wert in % rF
humStatus 1.3.6.1.4.1.3854.1.2.2.1.17.1.4.{n} -- 0=OK, 1=Warn, 2=Alarm
-- Spannungssensoren:
voltValue 1.3.6.1.4.1.3854.1.2.2.1.15.1.3.{n} -- Wert in V × 10
voltStatus 1.3.6.1.4.1.3854.1.2.2.1.15.1.4.{n} -- 0=OK, 1=Warn, 2=Alarm
4. OID-Referenz: Temperatur- und Leckagesensoren
Alle nachfolgenden OIDs basieren auf der Didactum Enterprise OID-Basis 1.3.6.1.4.1.3854. Der Platzhalter {n} steht für den Sensorindex (1 = erster Sensor, 2 = zweiter Sensor usw.).
Wichtig:
Didactum gibt Temperaturwerte mit Faktor 10 zurück (z.Bsp. 235 = 23,5°C). In PRTG unter „Factor" bei der Channel-Konfiguration den Wert 0,1 eintragen!
4.1 Temperatursensoren
| OID | Beschreibung | Einheit | Datentyp | Beispielwert |
|---|---|---|---|---|
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1 | Temperatur Sensor 1 (Wert × 10) | °C × 10 | Integer | 235 |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.2 | Temperatur Sensor 2 (Wert × 10) | °C × 10 | Integer | 198 |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.3 | Temperatur Sensor 3 (Wert × 10) | °C × 10 | Integer | 210 |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.4.1 | Temperatur Status Sensor 1 | Enum | Integer | 0 (OK) |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.4.2 | Temperatur Status Sensor 2 | Enum | Integer | 1 (Warnung) |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.7.1 | Temperatur Oberer Grenzwert Sensor 1 | °C × 10 | Integer | 350 |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.8.1 | Temperatur Unterer Grenzwert Sensor 1 | °C × 10 | Integer | 50 |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.2.1 | Temperatur Sensor 1 Name | Text | String | Temp_Front |
4.2 Leckagesensoren
| OID | Beschreibung | Einheit | Datentyp | Beispielwert |
|---|---|---|---|---|
| 1.3.6.1.4.1.3854.1.2.2.1.18.1.4.1 | Leckage Status Sensor 1 | Enum | Integer | 0 (OK) |
| 1.3.6.1.4.1.3854.1.2.2.1.18.1.4.2 | Leckage Status Sensor 2 | Enum | Integer | 0 (OK) |
| 1.3.6.1.4.1.3854.1.2.2.1.18.1.3.1 | Leckage Wert Sensor 1 (0 = trocken) | Status | Integer | 0 |
| 1.3.6.1.4.1.3854.1.2.2.1.18.1.2.1 | Leckage Sensor 1 Name | Text | String | Leak_Boden |
| 1.3.6.1.4.1.3854.1.2.2.1.18.1.5.1 | Leckage Alarm-Threshold Sensor 1 | Enum | Integer | 1 |
4.3 Luftfeuchtigkeitssensoren
| OID | Beschreibung | Einheit | Datentyp | Beispielwert |
|---|---|---|---|---|
| 1.3.6.1.4.1.3854.1.2.2.1.17.1.3.1 | Luftfeuchtigkeit Sensor 1 | % rF | Integer | 45 |
| 1.3.6.1.4.1.3854.1.2.2.1.17.1.3.2 | Luftfeuchtigkeit Sensor 2 | % rF | Integer | 52 |
| 1.3.6.1.4.1.3854.1.2.2.1.17.1.4.1 | Luftfeuchtigkeit Status Sensor 1 | Enum | Integer | 0 (OK) |
| 1.3.6.1.4.1.3854.1.2.2.1.17.1.7.1 | Oberer Grenzwert Sensor 1 | % rF | Integer | 80 |
| 1.3.6.1.4.1.3854.1.2.2.1.17.1.8.1 | Unterer Grenzwert Sensor 1 | % rF | Integer | 20 |
4.4 Weitere Sensor-OIDs
| OID | Beschreibung | Einheit | Datentyp | Beispielwert |
|---|---|---|---|---|
| 1.3.6.1.4.1.3854.1.2.2.1.15.1.3.1 | Spannung Sensor 1 (Wert × 10) | V × 10 | Integer | 2298 |
| 1.3.6.1.4.1.3854.1.2.2.1.15.1.4.1 | Spannung Status Sensor 1 | Enum | Integer | 0 (OK) |
| 1.3.6.1.4.1.3854.1.2.2.1.10.1.3.1 | Türkontakt Status 1 | Enum | Integer | 0 (geschlossen) |
| 1.3.6.1.4.1.3854.1.2.2.1.11.1.3.1 | Erschütterung / Bewegung Sensor 1 | Enum | Integer | 0 (keine) |
| 1.3.6.1.4.1.3854.1.2.2.1.14.1.3.1 | Rauchmelder Status 1 | Enum | Integer | 0 (OK) |
| 1.3.6.1.2.1.1.3.0 | System Uptime (sysUpTime) | Hundertstelsekunden | TimeTicks | 123456789 |
4.5 Status-Code-Bedeutung (Enum-Werte)
| Wert | Status | Beschreibung / PRTG-Interpretation |
|---|---|---|
| 0 | OK / Normal | Messwert innerhalb der Grenzwerte → PRTG: Up |
| 1 | Warnung | Messwert im Warnbereich → PRTG: Warning |
| 2 | Alarm / Kritisch | Grenzwert überschritten → PRTG: Down / Error |
| 3 | Sensor-Fehler | Sensor nicht erreichbar / defekt → PRTG: Error |
5. PRTG-Sensoren anlegen
5.1 Gerät in PRTG hinzufügen
- In PRTG zur gewünschten Gruppe navigieren, unter der das Didactum-Gerät erscheinen soll.
- Klick auf Gerät hinzufügen (Add Device). Hostname oder IP-Adresse eintragen.
- Einstellungen: SNMP-Version v2c, Community-String, Port 161.
- Gerät speichern. PRTG versucht nun, das Gerät per SNMP zu erreichen.
5.2 SNMP Custom Value Sensor (Einzelwert)
Für jeden Sensor-Wert wird ein eigener SNMP Custom Value Sensor angelegt:
- Am Didactum-Gerät in PRTG: + → Sensor hinzufügen → SNMP Custom Value.
- Konfiguration:
- Sensorname: z.Bsp. Temperatur Rack-Front
- OID: 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1
- SNMP Data Type: Integer
- Channel-Einstellungen (wichtig für Temperatursensoren!):
- Unit: Custom → Einheit: °C
- Factor: 0,1 (Wert ÷ 10, da Didactum × 10 ausgibt)
- Decimal Places: 1
- Grenzwerte (Limits):
- Warning limit (upper): 35 °C
- Error limit (upper): 40 °C
- Warning limit (lower): 5 °C
- Sensor speichern. PRTG beginnt nach dem konfigurierten Scanintervall mit der Datenerfassung.
5.3 SNMP Custom Table Sensor (alle Sensoren auf einmal)
Mit dem SNMP Custom Table Sensor können alle Kanäle mit einer einzigen Tabellen-OID abgefragt werden – besonders effizient für Geräte mit vielen Sensoren.
- Am Gerät: + → Sensor hinzufügen → SNMP Custom Table.
- Tabellen-OID eintragen:
- Temperaturen: 1.3.6.1.4.1.3854.1.2.2.1.16.1
- Leckage: 1.3.6.1.4.1.3854.1.2.2.1.18.1
- Spalten konfigurieren:
- Spalte .2 → Sensorname
- Spalte .3 → Messwert (Integer, Factor 0,1)
- Spalte .4 → Statuscode (0/1/2)
- Sensor-Kanalnamen aus der MIB-Spalte .2 automatisch übernehmen lassen.
- Grenzwerte und Benachrichtigungen konfigurieren, Sensor speichern.
Tipp: Der SNMP Custom Table Sensor reduziert die Anzahl benötigter Sensoren erheblich und belastet das Gerät weniger.
6. SNMP-Trap-Sensor konfigurieren
SNMP Traps erlauben dem Didactum-Gerät, bei Alarmen sofort eine Meldung an PRTG zu senden – ohne dass PRTG aktiv abfragen muss. Ideal für zeitkritische Ereignisse wie Leckage-Alarme.
6.1 SNMP-Trap-Receiver in PRTG aktivieren
- In PRTG: Setup → System Administration → Core & Probes → Probe-Einstellungen.
- Option SNMP Trap Receiver aktivieren. UDP Port 162 muss in der Firewall freigegeben sein.
- Sensor anlegen: + → Sensor hinzufügen → SNMP Trap Receiver.
- Trap-Filter: OID 1.3.6.1.4.1.3854 (alle Didactum-Traps), Source IP: IP des Didactum-Geräts.
- Am Didactum-Gerät: SNMP Trap Receiver = IP des PRTG-Servers, Port 162 eintragen.
6.2 Wichtige Didactum Trap-OIDs
| OID | Beschreibung | Typ |
|---|---|---|
| 1.3.6.1.4.1.3854.1.7.1 | Temperatur-Alarm Trap | Sendet OID + Wert |
| 1.3.6.1.4.1.3854.1.7.2 | Leckage-Alarm Trap | Status 0 oder 1 |
| 1.3.6.1.4.1.3854.1.7.3 | Luftfeuchtigkeits-Alarm Trap | Sendet OID + Wert |
| 1.3.6.1.4.1.3854.1.7.4 | Spannungs-Alarm Trap | Sendet OID + Wert |
| 1.3.6.1.4.1.3854.1.7.10 | Türkontakt-Alarm Trap | 0 = zu, 1 = offen |
| 1.3.6.1.4.1.3854.1.7.99 | Gerät-Neustart Trap | System reboot |
7. Benachrichtigungen und Alarme
- PRTG: Setup → Benachrichtigungen → Neue Benachrichtigung anlegen.
- Trigger: Sensor im Down- oder Error-Zustand → Sofort (0 Minuten Verzögerung).
- Methode: E-Mail an Administrator-Verteiler UND SMS an Bereitschaftsnummer.
- Betreff-Template: [ALARM] Leckage erkannt: %sensorname auf %device (%datetime)
- Sensor-Filter: Nur Sensoren mit Tag leckage oder didactum-leak benachrichtigen.
- Benachrichtigung dem Leckage-Sensor zuweisen: Sensor → Einstellungen → Benachrichtigungen.
7.2 Empfohlene Grenzwerte für Rack-Monitoring
| Sensortyp | Warnung (low) | Warnung (high) | Alarm (high) | Norm / Empfehlung |
|---|---|---|---|---|
| Temperatur (IT-Rack) | 5 °C | 30 °C | 35 °C | ASHRAE A1: 15–32 °C |
| Temperatur (USV-Raum) | 10 °C | 25 °C | 30 °C | Herstellervorgabe beachten |
| Luftfeuchtigkeit | 20 % rF | 70 % rF | 80 % rF | ASHRAE: 20–80 % rF |
| Leckage | – | – | Sofort (Wert ≥ 1) | 0 Minuten Delay |
| Spannung (230 V AC) | 207 V (−10 %) | 253 V (+10 %) | 260 V | EN 50160 |
8. Fehlerbehebung (Troubleshooting)
| Problem | Mögliche Ursache / Lösung |
|---|---|
| SNMP Timeout / No Response | Firewall: UDP Port 161 geöffnet? IP-Adresse korrekt? SNMP am Gerät aktiviert? Community-String stimmt überein? Allowed Managers zu restriktiv konfiguriert? |
| Falscher Temperaturwert (z. B. 235 statt 23,5) | Factor im Channel auf 0,1 setzen. Didactum gibt Werte × 10 aus. |
| OID liefert „noSuchObject" | Sensor nicht angeschlossen oder falscher Index. SNMP Walk durchführen, um existierende OIDs zu ermitteln. |
| MIB-Import schlägt fehl | MIB-Syntax prüfen (z.Bsp. mit MIB-Browser). Abhängige MIBs (RFC1213-MIB, SNMPv2-SMI) müssen ebenfalls vorhanden sein. |
| Traps kommen nicht an | UDP 162 in Windows-Firewall des PRTG-Servers freigeben. Trap-Receiver in PRTG aktiviert? Korrekte IP am Didactum-Gerät hinterlegt? |
| Sensor zeigt „Down" trotz OK-Wert | Grenzwert-Einstellungen prüfen. Bei Status-OIDs: Limit-Typ „nicht gleich 0" für Alarm konfigurieren. |
Diagnose-Befehle
# SNMP Walk – alle verfügbaren OIDs des Didactum-Geräts auflisten:
snmpwalk -v2c -c public 192.168.1.100 1.3.6.1.4.1.3854 # Einzelne OID abfragen (Sensor 1 Temperatur):
snmpget -v2c -c public 192.168.1.100 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1 # SNMP v3 Abfrage:
snmpget -v3 -l authPriv -u snmpuser -a SHA -A passwort123 \ -x AES -X encryptpw 192.168.1.100 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1
Anhang: OID-Schnell-Referenz
| # | OID | Sensor-Typ | PRTG-Sensor-Typ |
|---|---|---|---|
| 1 | 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.{n} | Temperaturwert (× 10) | SNMP Custom Value, Factor 0,1 |
| 2 | 1.3.6.1.4.1.3854.1.2.2.1.16.1.4.{n} | Temperatur-Status | SNMP Custom Value, Limits 0–0 |
| 3 | 1.3.6.1.4.1.3854.1.2.2.1.17.1.3.{n} | Luftfeuchtigkeit (%) | SNMP Custom Value |
| 4 | 1.3.6.1.4.1.3854.1.2.2.1.17.1.4.{n} | Luftfeuchtigkeits-Status | SNMP Custom Value, Limits 0–0 |
| 5 | 1.3.6.1.4.1.3854.1.2.2.1.18.1.4.{n} | Leckage-Status | SNMP Custom Value, Error if ≥ 1 |
| 6 | 1.3.6.1.4.1.3854.1.2.2.1.15.1.3.{n} | Spannung (V × 10) | SNMP Custom Value, Factor 0,1 |
| 7 | 1.3.6.1.4.1.3854.1.2.2.1.10.1.3.{n} | Türkontakt-Status | SNMP Custom Value |
| 8 | 1.3.6.1.4.1.3854.1.2.2.1.14.1.3.{n} | Rauchmelder-Status | SNMP Custom Value, Error if ≥ 1 |
| 9 | 1.3.6.1.4.1.3854.1.7.* | SNMP Traps (alle) | SNMP Trap Receiver |
| 10 | 1.3.6.1.2.1.1.3.0 | System Uptime | SNMP Custom Value |