SNMP

Das Simple Network Management Protocol (SNMP) bietet die Möglichkeit verschiedene Netzwerkelemente von einer zentralen Stelle aus zu überwachen. Die verschiedenen Object Identifier (OID) werden in sogenannten Management Information Base (MIB) zusammengefasst.  Es gibt verschiedene SNMP-Versionen, die sich hauptsächlich in der Sicherheit unterscheiden. KentixONE unterstützt SNMP in der Version 2 und Version 3. KentixONE kann zum einen SNMP-V2/3 fähige Geräte abfragen und kann auch selbst per SNMP-V2/3 von fremden Systemen (z.B. Netzwerkmonitoring, SCADA,etc.) abgefragt werden. Weiterhin bietet KentixONE die Möglichkeit sogenannte SNMP-Taps (SNMP Event-Meldungen) zu empfangen.

Alle hier dargestellten API- und SNMP Beispiele beziehen sich auf die zum Zeitpunkt der Erstellung des Artikes aktuellen Versionen der jeweiligen Produkte. Diese unterliegen fortlaufender Entwicklung.
Die ReST API sowie die SNMP Schnittstellen werden der Dokumentation entsprechend ausgeliefert. KENTIX setzt bei Verwendung dieser Schnittstellen grundsätzliche Kenntnisse dieser Technologien beim Anwender voraus.
Um Sie optimal bei der Umsetzung ihrer individuellen Projektanforderungen zu unterstützen, bieten wir passende Support-Pakete an. Ein entsprechendes Zeitkontingent können sie einfach im Kentix Shop buchen.

OID-Glossar

Das OID-Glossar mit den einzelnen Werten kann direkt vom Gerät heruntergeladen werden und zeigt Ihnen eine CSV-Datei mit allen möglichen Abfragewerten Ihres Systems.

Der Aufbau und die Inhalte des OID Glossars werden dem Stand der Entwicklung angepasst und aktualisiert.
Die im folgenden verwendeten Beispiele dienen der Beschreibung der grundlegenden Funktion.
Verwenden Sie immer die aktuelle Version des IOD-Glossars aus dem verwendeten Gerät.

Download des OID Glossar

Aufbau der MIB

Die OIDs der Kentix-Geräte können am besten mit einem MIB-Browser ausgelesen werden (z.B. http://ireasoning.com/mibbrowser.shtml)

Der grundlegende Aufbau für einen AlarmManager sieht folgendermaßen aus:

.1.3.6.1.4.1.37954.kentixdevices
.1.3.6.1.4.1.37954.5.1system
.1.3.6.1.4.1.37954.5.1.1valuemultiplier
.1.3.6.1.4.1.37954.5.1.2alarmstate
.1.3.6.1.4.1.37954.5.1.3energy
.1.3.6.1.4.1.37954.5.2sensors
.1.3.6.1.4.1.37954.5.2.1generalTable
.1.3.6.1.4.1.37954.5.2.2temperatureTable
.1.3.6.1.4.1.37954.5.2.3humidityTable
.1.3.6.1.4.1.37954.5.2.4dewpointTable
.1.3.6.1.4.1.37954.5.2.5coTable
.1.3.6.1.4.1.37954.5.2.6motionTable
.1.3.6.1.4.1.37954.5.2.7vibrationTable
.1.3.6.1.4.1.37954.5.2.8latencyTable
.1.3.6.1.4.1.37954.5.2.100inputs
.1.3.6.1.4.1.37954.5.2.101outputs
.1.3.6.1.4.1.37954.5.2.102pdus
.1.3.6.1.4.1.37954.5.3zones
.1.3.6.1.4.1.37954.5.3.1zoneTable
.1.3.6.1.4.1.37954.5.4logbook
.1.3.6.1.4.1.37954.5.4.1systemLogbookTable
.1.3.6.1.4.1.37954.5.4.2accessLogbookTable
.1.3.6.1.4.1.37954.5.4.3eventLogbookTable
.1.3.6.1.4.1.37954.5.100event
AlarmManager Beispiel Tabelle MIB

Konfiguration in KentixOne

Unter Konfiguration → SNMP kann die Funktion aktiviert werden. Die Kentix-Geräte unterstützen die SNMP-Versionen 2 und 3 und folgende SNMP-Typen:

Daten bereitstellenDie Daten können von einem externen Gerät abgefragt werden
Trap versendenAlarmmeldungen werden an externe Geräte versendet
Daten abrufenDas Kentix-Gerät ruft Daten von externen Systemen ab
SNMP Tabelle SNMP-Typen
SNMP Type Selection

Trap Beschreibung

AlarmManager / PowerManager / PDU

NameOIDBeschreibungMögliche Werte
eventGlobalIndex.1.3.6.1.4.1.37954.5.100.1Eindeutige Identifikationsnummer des Gerätsz.B 5 (AlarmManager)
2.  eventTimestamp.1.3.6.1.4.1.37954.5.100.2Zeitstempel zum Zeitpunkt des Alarms/Quittierbarstatus im Unix-Zeitformatz.B. 1600438199 (Freitag 18. September 2020)
3. eventTraptype.1.3.6.1.4.1.37954.5.100.3Alarmtyp wird als Integer eingetragen 1 = Temperatur
 2 = Luftfeuchte
 3 = Taupunkt
 4 = Fire (Co, DI falls dieser als Brandalarm konfiguriert wurde)
 5 = Einbruch (Bewegung, ReedKontakt)
 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 (Tilt, DI falls dieser als Brandalarm konfiguriert wurde)
52 = Verbindung verloren (Kamera, Gerät)
53 = Spannungsausfall
54 = Batterie
101 = Digitaler Eingang (Falls nicht als Brand- oder Sabotagealarm konfiguriert)
4. eventAlarmState.1.3.6.1.4.1.37954.5.100.4Alarmstatus0 = Kein Alarm vorhanden
1 = Anstehender Alarm (Alarmstate ist auch 1 wenn der Alarm quittierbar ist)
5. eventAlarmDescription.1.3.6.1.4.1.37954.5.100.5Je nach Zuordnung des Alarms werden folgende Werte ausgegebenSabotagealarm = Bei Sabotagealarm
Systemmeldung = Bei Batteriealarm
Alarm = Bei den restlichen Alarmen (Daueraktiv, Scharfaktiv etc.)
6. eventSource.1.3.6.1.4.1.37954.5.100.6Welcher Alarm ausgelöst wurdeBatterie
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 der Alarm durch einen DI ausgelöst wurde)
7. eventDevice.1.3.6.1.4.1.37954.5.100.7Gerätename welches den Alarm ausgelöst hatz.B. MultiSensor Büro 1
8. eventMeasurement.1.3.6.1.4.1.37954.5.100.8Messwert bei dem der Alarm/Wiedergut Trap ausgelöst wurdez.B 30,2 °C
9. eventAlarmzone.1.3.6.1.4.1.37954.5.100.9Name der Alarmzone in der der Alarm aufgetreten istz.B: Serverraum

AccessManager

NameOIDBeschreibungMögliche Werte
eventGlobalIndex.1.3.6.1.4.1.37954.5.100.1eindeutige Identifikationsnummer des Gerätsz.B 7 (AccessManager)
2. eventTimestamp.1.3.6.1.4.1.37954.5.100.2Zeitstempel zum Zeitpunkt des Alarms/Quittierbarstatus im Unix-Zeitformatz.B. 1600438199 (Freitag 18. September 2020)
3. eventTraptype.1.3.6.1.4.1.37954.5.100.3Trap-Typ151 = Zugang
4. eventTrapstate.1.3.6.1.4.1.37954.5.100.4Trap-Status0 = kein Zugang1 = Zugang gewährt
5. eventDoor.1.3.6.1.4.1.37954.5.100.5Name der Türz.B. Rack 01
6. eventUser.1.3.6.1.4.1.37954.5.100.6Name des Benutzers, der gebucht hatz.B. admin
7. eventDetail.1.3.6.1.4.1.37954.5.100.7Details zur Buchungz.B. keine Türberechtigung
8. eventAlarmzone.1.3.6.1.4.1.37954.5.100.8Name der Zone

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

War dieser Artikel hilfreich?

Verwandte Artikel