Wie überwache ich Geräte im Netzwerk über SNMP und lese spezifische Werte aus?
Diese Anleitung erklärt kurz, was SNMP ist, wie Sie SNMP in KentixONE aktivieren und wie Sie OID‑Glossar, MIB‑Aufbau und Trap‑Informationen für die Integration in externe Systeme nutzen.
Voraussetzungen
- Zugriff auf das KentixONE Web‑Interface
- Rolle mit Rechten zum Bearbeiten der Konfiguration
- Optional: MIB‑Browser (z.B. iReasoning) zum Testen der OIDs
Übersicht
- SNMP (Simple Network Management Protocol) dient der Überwachung und Abfrage von Geräten über OIDs, die in einer MIB beschrieben sind.
- KentixONE unterstützt SNMP v2c und v3. Zusätzlich können SNMP‑Traps (Ereignisse) an Fremdsysteme gesendet werden.
- Das OID‑Glossar kann direkt aus KentixONE heruntergeladen werden und listet alle verfügbaren Abfragewerte des Systems.
Schritt‑für‑Schritt‑Anleitung
1. SNMP in der Konfiguration öffnen
Navigieren Sie zu Konfiguration → Kommunikation → SNMP.
2. SNMP aktivieren und Optionen setzen
Aktivieren Sie SNMP und wählen Sie optional „Sofortabfrage nach Trap-Empfang“. Laden Sie bei Bedarf das „OID Glossar“ herunter.
Sie müssen nach der Aktivierung speichern, um das "OID Glossar" sichtbar zu machen.
SNMP‑Versionen: Nutzen Sie v3, wenn möglich, da hier Authentifizierung/Verschlüsselung verfügbar ist. Für einfache Tests reicht v2c.
3. Zugänge anlegen
Unter „SNMP Zugänge“ können Sie Abfrage‑Konten für externe Systeme hinterlegen (z.B. Community für v2c oder User/Pass/Priv für v3).
| SNMP-Typ | Beschreibung |
|---|---|
| Daten bereitstellen | Die Daten können von einem externen Gerät abgefragt werden |
| Daten abrufen | Das Kentix-Gerät ruft Daten von externen Systemen ab |
| Trap versenden | Alarmmeldungen werden an externe Geräte versendet |
4. OID‑Glossar herunterladen
Über „Download OID Glossar“ erhalten Sie eine CSV‑Übersicht aller OIDs. Nutzen Sie diese für Monitoring‑Systeme und MIB‑Browser.
5. MIB‑Aufbau verstehen
- Kentix‑OIDs beginnen unterhalb des Enterprise‑Zweigs. Häufige Bereiche sind „system“, „sensors“, „zones“, „logbook“, „event“.
- Tabellen (…Table) enthalten zeilenbasierte Mess‑ und Statuswerte wie Temperatur, Feuchte, CO, Bewegung, Vibration etc.
Aufbau der MIB
Die OIDs der Kentix‑Geräte können am besten mit einem MIB‑Browser ausgelesen werden (z. B. https://ireasoning.com/mibbrowser.shtml).
Der grundlegende Aufbau für einen AlarmManager sieht folgendermaßen aus:
| OID | Name |
|---|---|
| .1.3.6.1.4.1.37954.5 | kentixdevices |
| .1.3.6.1.4.1.37954.5.1 | system |
| .1.3.6.1.4.1.37954.5.1.1 | valuemultiplier |
| .1.3.6.1.4.1.37954.5.1.2 | alarmstate |
| .1.3.6.1.4.1.37954.5.1.3 | energy |
| .1.3.6.1.4.1.37954.5.2 | sensors |
| .1.3.6.1.4.1.37954.5.2.1 | generalTable |
| .1.3.6.1.4.1.37954.5.2.2 | temperatureTable |
| .1.3.6.1.4.1.37954.5.2.3 | humidityTable |
| .1.3.6.1.4.1.37954.5.2.4 | dewpointTable |
| .1.3.6.1.4.1.37954.5.2.5 | coTable |
| .1.3.6.1.4.1.37954.5.2.6 | motionTable |
| .1.3.6.1.4.1.37954.5.2.7 | vibrationTable |
| .1.3.6.1.4.1.37954.5.2.8 | latencyTable |
| .1.3.6.1.4.1.37954.5.2.100 | inputs |
| .1.3.6.1.4.1.37954.5.2.101 | outputs |
| .1.3.6.1.4.1.37954.5.2.102 | pdus |
| .1.3.6.1.4.1.37954.5.3 | zones |
| .1.3.6.1.4.1.37954.5.3.1 | zoneTable |
| .1.3.6.1.4.1.37954.5.4 | logbook |
| .1.3.6.1.4.1.37954.5.4.1 | systemLogbookTable |
| .1.3.6.1.4.1.37954.5.4.2 | accessLogbookTable |
| .1.3.6.1.4.1.37954.5.4.3 | eventLogbookTable |
| .1.3.6.1.4.1.37954.5.100 | event |
AlarmManager Beispiel Tabelle MIB
6. Trap‑Typen richtig interpretieren
Traps enthalten u.a. eine eindeutige Geräte‑ID (eventGlobalIndex), einen Zeitstempel, den Trap‑Typ (eventTraptype) sowie Detailinformationen (Quelle, Gerät, Messwert, Alarmzone). Dadurch können Alarme eindeutig korreliert werden.
Trap Beschreibung (Variablen)
Nachfolgend sind die wichtigsten Trap-Variablen inkl. OIDs und ihrer Bedeutung aufgeführt. Die Werte entsprechen der Kentix MIB und dienen der Auswertung in externen Systemen.
AlarmManager / PowerManager / PDU
| Name | OID | Beschreibung | Mögliche Werte |
|---|---|---|---|
| eventGlobalIndex | .1.3.6.1.4.1.37954.5.100.1 | Eindeutige Identifikationsnummer des Geräts | z. B. 5 (AlarmManager) |
| eventTimestamp | .1.3.6.1.4.1.37954.5.100.2 | Zeitstempel zum Zeitpunkt des Alarms/Quittierbarstatus im Unix-Zeitformat | z. B. 1600438199 (Freitag 18. September 2020) |
| eventTraptype | .1.3.6.1.4.1.37954.5.100.3 | Alarmtyp wird als Integer eingetragen | 1=Temperatur, 2=Luftfeuchte, 3=Taupunkt, 4=Fire (DI als Brandalarm), 5=Einbruch, 6=Vibration, 7=Latenz, 8=Service-Verbindung verloren, 9=SNMP, 11=Hitze, 12=Luftqualität, 14=TI-Feuer, 15=PeopleCount, 16=Feuer-Luftqualität, 18=CO2, 21=Stromabweichung, 24=Wirkleistungsüberschreitung, 30=Sicherung, 31=RCM (AC), 32=RCM (DC), 33=Stromausfall, 51=Sabotage (z. B. Tilt/DI), 52=Verbindung verloren (Kamera/Gerät), 53=Spannungsausfall, 54=Batterie, 101=Digitaler Eingang (kein Brand-/Sabotagealarm) |
| eventAlarmState | .1.3.6.1.4.1.37954.5.100.4 | Alarmstatus | 0=Kein Alarm, 1=Anstehender Alarm (auch wenn quittierbar) |
| eventAlarmDescription | .1.3.6.1.4.1.37954.5.100.5 | Je nach Zuordnung des Alarms werden folgende Werte ausgegeben | Sabotagealarm (bei Sabotagealarm); Systemmeldung (bei Batteriealarm); Alarm (bei restlichen Alarmen – Daueraktiv, Scharfaktiv etc.) |
| eventSource | .1.3.6.1.4.1.37954.5.100.6 | Welcher Alarm ausgelöst wurde | Batterie; CO/Kohlendioxid; Thermalbild; Personenzählung; Luftqualität; Hitzemelder; Taupunkt; Power; Raumtemperatur; Rel. Luftfeuchte; Reed; Bewegung; Latenz; Verbindung; Sabotage; Vibration; SNMP; Name des Digitalen Eingangs (falls über DI ausgelöst) |
| eventDevice | .1.3.6.1.4.1.37954.5.100.7 | Gerätename, welches den Alarm ausgelöst hat | z. B. MultiSensor Büro 1 |
| eventMeasurement | .1.3.6.1.4.1.37954.5.100.8 | Messwert, bei dem der Alarm/Wiedergut Trap ausgelöst wurde | z. B. 30,2 °C |
| eventAlarmzone | .1.3.6.1.4.1.37954.5.100.9 | Name der Alarmzone, in der der Alarm aufgetreten ist | z. B. Serverraum |
AccessManager
| Name | OID | Beschreibung | Mögliche Werte |
|---|---|---|---|
| eventGlobalIndex | .1.3.6.1.4.1.37954.5.100.1 | Eindeutige Identifikationsnummer des Geräts | z. B. 7 (AccessManager) |
| eventTimestamp | .1.3.6.1.4.1.37954.5.100.2 | Zeitstempel zum Zeitpunkt des Alarms/Quittierbarstatus im Unix-Zeitformat | z. B. 1600438199 |
| eventTraptype | .1.3.6.1.4.1.37954.5.100.3 | Trap-Typ | 151 = Zugang |
| eventTrapstate | .1.3.6.1.4.1.37954.5.100.4 | Trap-Status | 0 = kein Zugang, 1 = Zugang gewährt |
| eventDoor | .1.3.6.1.4.1.37954.5.100.5 | Name der Tür | z. B. Rack 01 |
| eventUser | .1.3.6.1.4.1.37954.5.100.6 | Name des Benutzers, der gebucht hat | z. B. admin |
| eventDetail | .1.3.6.1.4.1.37954.5.100.7 | Details zur Buchung | z. B. keine Türberechtigung |
| eventAlarmzone | .1.3.6.1.4.1.37954.5.100.8 | Name der Zone | — |
Hinweis: Je nach Firmware-Version können zusätzliche Felder vorhanden sein. Maßgeblich ist das jeweils mit KentixONE ausgelieferte OID-Glossar/MIB.
Ausführlichere Informationen finden Sie auch hier SNMP.
Tipps & Tricks
- Starten Sie mit v3 (authPriv), wenn Ihr System es unterstützt; legen Sie starke Passwörter/Keys fest.
- Nutzen Sie das OID‑Glossar als „Wahrheit“ für Abfragen; prüfen Sie Änderungen nach Firmware‑Updates.
- Für Tests: per MIB‑Browser gezielt einzelne OIDs pollen und mit der KentixONE‑Maske vergleichen.
- Laden Sie ein MIB-File (SNMP V2/3) direkt auf unserer Webseite (Ressourcen -> Software Downloads) herunter.
Beispiele für Abfragen
Batteriestandsabfrage bei DoorLocks
Der Batteriestand bei der SNMP-Abfrage gibt folgende Werte zurück:
- 0 = Batterie OK
- 1 = Warnung, Batterie demnächst leer (hält aber in der Regel noch mehrere Tage)
- 2 = Kritisch, Batterie fast leer (sollte „sofort“ getauscht werden)
- 3 = Batterie leer
GSM-Signal
Die Abfrage auf das GSM-Signal liefert folgende Werte:
- 0 = kein Empfang
- 1 = 25% Empfang
- 2 = 50% Empfang
- 3 = 75% Empfang
- 4 = 100% Empfang
Fehlerbehebung
- Keine Werte per Abfrage: Prüfen Sie SNMP‑Version, Community/User, Firewall und ob SNMP in KentixONE aktiviert ist.
- Falsche Messwerte: Vergleichen Sie OID und Index (bei Tabellen); nutzen Sie das aktuelle OID‑Glossar.
- Traps kommen nicht an: Ziel‑Host/Port prüfen, Netzwerk‑Erreichbarkeit und ob Traps im System aktiviert sind.
Glossar
- OID: Object Identifier – eindeutige Kennung eines Werts in der MIB.
- MIB: Management Information Base – Struktur, die alle OIDs eines Herstellers/Funktionsbereichs beschreibt.
- Trap: Asynchrone Ereignismeldung, die ein Gerät an einen SNMP‑Manager sendet.
- v2c/v3: Protokollversionen. v3 unterstützt Authentifizierung/Privatsphäre (auth/priv).