SNMP

Funktion

Fragt ein Gerät (üblicherweise eine Art Netzwerkgerät) durch Anfordern einer OID nach SNMP-Daten ab. Ermöglicht das Durchsuchen (Browsing) nach OIDs.

Alarmierung

Übertragungszeit, benutzerdefinierte Werte, Diff-Werte und String-Werte

Das Simple Network Management Protocol (SNMP) ist das mit Abstand vorherrschende Protokoll im Netzwerkmanagement. Ein wesentlicher Grund für seine weite Verbreitung ist – neben der Tatsache, dass es der wichtigste Internetstandard für das Netzwerkmanagement ist – seine relative Einfachheit. Die Implementierung von SNMP-Management in einem vernetzten Gerät ist wesentlich unkomplizierter als die meisten anderen standardisierten oder nicht standardisierten Ansätze des Netzwerkmanagements.

Der SNMP-Manager bzw. die Management-Anwendung verwendet eine klar definierte Benennungssyntax, um die Variablen gegenüber dem SNMP-Agenten zu spezifizieren. Objektnamen in dieser Syntax werden als Object Identifiers (Object IDs oder OIDs) bezeichnet.

OIDs sind Zahlenfolgen, die ein Objekt gegenüber einem SNMP-Agenten eindeutig identifizieren. OIDs sind in einer hierarchischen, umgekehrten Baumstruktur angeordnet. Der OID-Baum beginnt bei der Wurzel (Root) und verzweigt sich in Äste. Jeder Punkt im OID-Baum wird als Knoten bezeichnet, und jeder Knoten besitzt einen oder mehrere Zweige oder endet mit einem Blattknoten. Das Format einer OID ist eine Folge von Zahlen, die durch Punkte getrennt sind.

Die folgenden SNMP-Variablentypen werden für Werte unterstützt:

ASN_COUNTER

Nicht negative 32-Bit-Ganzzahl, die nur steigen kann

ASN_GAUGE

32-Bit-Ganzzahl

ASN_INTEGER

32-Bit-Ganzzahl (-232 bis 232) RFC 1442

ASN_INTEGER64

64-Bit-Ganzzahl (-264 bis 264) RFC 1442

ASN_OPAQUE

Float und Double unterstützt

ASN_UNSIGNED64

64-Bit ohne Vorzeichen (unsigned)

ASN_COUNTER64

64-Bit ohne Vorzeichen (unsigned)

ASN_TIMETICKS

Ohne Vorzeichen (unsigned)

All diese Werte sowie die Differenz zur letzten Messung werden in Float konvertiert und anschließend an den Server übertragen.

Diff-Werte der oben genannten Typen werden automatisch durch die Zeit seit der letzten Messung dividiert ((currentValue - previousValue) / (currentTimeSeconds - previousTimeSeconds)). Das bedeutet, dass wir für solche Diff-Werte immer eine Rate pro Sekunde erhalten.

ASN_BIT_STR

ASN_OCTET_STR

Diese Werte sind Strings und können beliebige druckbare Zeichen enthalten.

SNMP-Funktionen

  • Online-MIB-Browser zur OID-Auswahl

  • Unbegrenzte MIB-Dateien, Speicherort: /usr/share/snmp/mibs auf jedem SKOOR Engine Kollektor

  • Konfigurierbare Maßeinheit

  • Automatische Differenzwerte

  • Unterstützung für Version 1, 2c und v3 PDU

  • Unterstützung für v3-Verschlüsselung

  • n-stufige Alarmierung

  • MIB2-Schnittstellenauswahl nach Namen

  • Zuordnung von OID-Namen zu OID-Nummern

  • Einstellbare Wiederholungen und Timeouts

  • Unterdrückbare Werte (reduziert die DB-Größe)

  • Strings (Zuordnung einer Zahl zu Text)

  • Zahlen aus Text-OID extrahieren (nur erster Wert)

SNMP-Details

SNMP Parameter

Der Eingabebereich Authentication wird nur angezeigt, wenn SNMP-Version 3 ausgewählt ist.

Parameter

Beschreibung

UDP port

Wählen Sie den UDP-Port aus (Standard ist 161).

Retries

Anzahl der Wiederholungsversuche, falls die Anfrage fehlschlägt. Standard sind 2 Wiederholungen.

Timeout

Wählen Sie das Timeout für die Anfrage aus. Auf den meisten Geräten werden SNMP-Anfragen mit niedriger Priorität verarbeitet, verwenden Sie daher ein ausreichend hohes Timeout. Standard ist 2 s.

Version

Wählen Sie die SNMP-Version aus, die vom Remote-SNMP-Daemon bereitgestellt wird. Folgende Optionen stehen zur Verfügung:

Version 1
Version 2c
Version 3

Security level

Die Sicherheitsstufe definiert, wie die SNMP-Anfrage gesendet wird. Diese Auswahl ist nur verfügbar, wenn SNMP v3 verwendet wird. Folgende Optionen stehen zur Verfügung:
No authentication, no encryption
Authentication, no encryption
Authentication, encryption

Username

Für die Authentifizierung, nur sichtbar, wenn SNMP v3 verwendet wird.

Authent. passphrase

Passphrase für die Authentifizierung, nur sichtbar, wenn SNMP mit Authentifizierung verwendet wird.

Authent. protocol

Protokoll für die Authentifizierung, nur sichtbar, wenn SNMP mit Authentifizierung verwendet wird. Derzeit verfügbare Optionen sind MD5 oder SHA. Standard ist MD5.

Privacy passphrase

Für die Verschlüsselung, nur sichtbar, wenn SNMP mit Authentifizierung und Verschlüsselung verwendet wird.

Privacy protocol

Für die Verschlüsselung, nur sichtbar, wenn SNMP mit Authentifizierung und Verschlüsselung verwendet wird. Derzeit verfügbare Optionen sind DES und AES. Standard ist DES.

Community

Die meisten Netzwerkgeräte erlauben unterschiedliche Stufen des SNMP-Zugriffs, zum Beispiel: READ ONLY oder READ/WRITE. Jede dieser Zugriffsstufen hat in der Regel einen eigenen Community-String. Um Daten zu lesen, muss nur die READ-Community bekannt sein, die üblicherweise public lautet.

Request OID

Geben Sie die Management Information Base (MIB) OID für die Anfrage ein. Wenn die OID unbekannt ist, kann sie auf dem Gerät des Jobs mit dem Online-Browser gesucht werden. Weitere OIDs können innerhalb eines einzigen SNMP-Jobs durch Klicken auf die Schaltfläche „+“ neben der Schaltfläche Browse angefordert werden. Wenn mehr als eine OID eingegeben wird, wird die Ausgabe aller OIDs nacheinander in dieselbe Ausgabedatei angehängt.

Overflow

Belassen Sie diese Einstellung auf Auto. Sie übernimmt die Diff-Wert-Berechnung, wenn der Zähler auf 0 zurückgesetzt wird. Dies verhindert negative Diff-Werte.

Suppress transfer time

Standardmäßig wird die Zeit, die für die Übertragung der SNMP-Daten benötigt wird, in der Datenbank gespeichert. Wenn diese Information irrelevant ist, aktivieren Sie dieses Kontrollkästchen, um Speicherplatz in der Datenbank zu sparen.

Suppress value
Suppress diff value
Suppress string value
Suppress info message

Aktivieren Sie diejenigen SNMP-Ausgabetypen, die nicht berücksichtigt werden sollen.

Wenn das Kontrollkästchen Suppress info message aktiviert ist, wird die SNMP-String-Ausgabe nicht an den Server gesendet. Der Rückgabewert wird nur dann auf Invalid value gesetzt, wenn entweder ein Wert (value) oder ein Diff-Wert (diff value) gewünscht ist und kein Wert aus dem String extrahiert werden kann.

Die Kontrollkästchen Suppress value, Suppress diff value und

Map string to value

Definieren Sie eine Zuordnung von SNMP-String-Objekten zu numerischen Werten.

Ein String-Wert kann direkt als String-Wert extrahiert werden oder durch Definieren einer String-Map im Format 1=foo,2=bar,0=*, was bedeutet, dass der String foo in den numerischen Wert 1, der String bar in den numerischen Wert 2 und (optional) alles andere in den Wert 0 konvertiert wird. Leerzeichen sind in dieser Definition nicht zulässig.

Wenn keine String-Map definiert ist oder die Zuweisung fehlschlägt (kein Standard-Operator definiert), wird der String nach dem ersten Auftreten numerischer Zeichen durchsucht und das Ergebnis wie angefordert an den Server übertragen (Wert und/oder Diff-Wert).

Define Unit

Siehe Abschnitt SNMP Unit/Divisor unten.

Die Dropdown-Liste Tags ermöglicht das Einfügen vordefinierter Variablen in die obigen Felder, z. B. $NAME$ für den Namen des Jobs.

Browse online

Um eine bestimmte SNMP-OID auf dem Remote-SNMP-Agenten zu finden und als SNMP-Anfrage zu verwenden, klicken Sie auf die Schaltfläche Browse online. Es ist hilfreich, die ungefähre Position im Baum zu kennen, um die Suchzeit, den Netzwerkverkehr und die Ausgabegröße zu begrenzen. Geben Sie den korrekten Community-String für den SNMP-Agenten ein und wählen Sie die SNMP-Version im Abschnitt Connection aus. Die am häufigsten verwendeten MIBs können aus dem Dropdown-Menü ausgewählt werden, beginnend bei Root, was nur ausgewählt werden sollte, wenn die Position des benötigten Objekts völlig unbekannt ist:

Starten Sie den Vorgang mit der Schaltfläche Start scan:

Der Scan kann je nach Anzahl der Objekte unterhalb der ausgewählten Root-OID einige Zeit dauern. Klicken Sie auf Refresh, bis der Download state Complete anzeigt:

Der Download counter zeigt die Anzahl der gefundenen OIDs an. Um sie anzuzeigen, wählen Sie Show tree oder Show flat. Um eine OID auszuwählen, klicken Sie einfach auf den OID-Link.

Beispiel 1 - Baumansicht mit Typ und Wert

    

Beispiel 2 - Flache Ansicht mit Wert

    

Wenn die Ausgabe des gescannten Baums keine Textinformationen, sondern nur OIDs der Form

1.3.6.1.4.1.13424.11.1.1.25

anzeigt, ist die MIB für das gescannte Gerät wahrscheinlich nicht installiert. Um nach SNMP-MIBs zu suchen, durchsuchen Sie die Website des Geräteherstellers oder die Homepage MIB Depot nach öffentlich verfügbaren MIBs.

Generische SNMP-Namensauflösung

Einige SNMP-Server ordnen nicht immer dieselbe OID demselben Wert zu. Das Auslesen der Festplattenauslastung aus einer Host-MIB funktioniert möglicherweise so lange, bis eine neue Festplatte zu diesem System hinzugefügt wird. Es ist möglich, dass sich der Index (der im folgenden Beispiel .2 lautet) ändert.

Um dies zu vermeiden, kann SKOOR Engine eine benutzerdefinierte Resolve OID für die Zuordnung von Namen zu Indizes verwenden. Dazu ersetzen wir den Index durch einen String, der mit dem Muster zwischen zwei $-Zeichen gegen die Resolve OID abgeglichen wird. Vor der Ausführung der Abfrage ersetzt SKOOR Engine das $string$ durch den gefundenen entsprechenden Index. Hier ist ein Beispiel für eine OID, aus der ein Wert ausgelesen werden soll:

   .iso.org.dod.internet.mgmt.mib-2.host.hrStorage.hrStorageTable.hrStorageEntry.hrStorageUsed.2

Anstatt diesen String als Request OID einzugeben, suchen Sie zuerst nach dem SNMP-Beschreibungs-String der Festplatte, der unter der folgenden OID gespeichert ist:

   .iso.org.dod.internet.mgmt.mib-2.host.hrStorage.hrStorageTable.hrStorageEntry.hrStorageDescr

Ihr Wert lautet: C:\ Label: Serial Number dc133042

Ersetzen Sie nun die Zahl 2 durch den obigen Wert, umgeben von zwei $-Zeichen:

   iso.org.dod.internet.mgmt.mib-2.host.hrStorage.hrStorageTable.hrStorageEntry.hrStorageUsed.$C:\ Label: Serial Number dc133042$

Sobald das zweite $-Zeichen eingegeben wird, erscheint eine neue Zeile namens Resolve OID unterhalb der Zeile Request OID1. Geben Sie hier die obige Beschreibungs-OID ein:

   .iso.org.dod.internet.mgmt.mib-2.host.hrStorage.hrStorageTable.hrStorageEntry.hrStorageDescr

$C:\ Label: Serial Number dc133042$ wird durch 2 ersetzt.

SNMP-Standardwert

Wenn die OID-Namensauflösung fehlschlägt (siehe Abschnitt oben), kann ein Standardindex definiert werden. Im obigen Beispiel würde man den Standardindex durch ein Leerzeichen getrennt nach der Request OID schreiben:

   iso.org.dod.internet.mgmt.mib-2.host.hrStorage.hrStorageTable.hrStorageEntry.hrStorageUsed.$C:\ Label: Serial Number dc133042$ 2

SNMP Unit/Divisor

Die SNMP-Ausgabe im Beispiel aus dem obigen Abschnitt lautet:

hrStorageDescr.2              C:\ Label: Serial Number dc133042
hrStorageAllocationUnits.2    4096 Bytes
hrStorageSize.2               2120572
hrStorageUsed.2               1839613

Um stattdessen das Ergebnis der genutzten Speicherkapazität in GB zu erhalten, muss der korrekte Divisor eingestellt werden.

Der Windows Explorer liefert uns folgende Angaben zum Dateisystem auf Laufwerk C:\:

Volume: 8283MB, 8.08GB Total Size, Freespace 1.07GB

Daher muss man hrStorageUsed.2 mit 4096 multiplizieren, um den Wert in Bytes zu erhalten, und anschließend dreimal durch 1024 teilen, um den Wert in GB zu erhalten.

   1839613 x 4096 / 1024 / 1024 / 1024 = 7.01GB belegt (was den Angaben im Explorer entspricht)

Um den SKOOR Engine Divisor festzulegen, kombinieren Sie 1024 x 1024 x 1024 / 4096 = 262144

Drücken Sie die Schaltfläche Unit, um den Namen des Wertes, seine Einheit und seinen Divisor zu definieren:

Das Ergebnis im Wertebereich nach Ausführung des SNMP-Jobs lautet 7.01 GB.

Um stattdessen %used zu erhalten, verwenden Sie diese Formel: hrStorageUsed / hrStorageSize x 100, sodass der Divisor 21205.72 beträgt.

SNMP-Jobs mit mehreren OIDs

Es ist möglich, mehrere OIDs innerhalb desselben SNMP-Jobs auszuwerten. Alle SNMP-Abfragen müssen für das Gerät gültig sein, dem der SNMP-Job zugeordnet ist (es ist nicht möglich, Abfragen für verschiedene Geräte in einem SNMP-Job zu definieren). Zusätzliche OIDs werden durch Klicken auf die Plus-Schaltfläche neben der Schaltfläche Browse online aktiviert. Sobald zusätzliche OIDs hinzugefügt werden, erscheinen unten im Abschnitt Results zusätzliche Ergebnisfelder:

Jede OID hat einen separat konfigurierbaren Ausgabebereich sowie eine eigene Map string to value-Definition und eine eigene Schaltfläche Unit. Die Übertragungszeit kann global unterdrückt werden.

Das Beispiel verwendet Resolve OIDs für jede der 3 OIDs. Einzelheiten finden Sie im Abschnitt Generische SNMP-Namensauflösung oben.

Die erste und zweite OID fragen die Zähler ifInOctets und ifOutOctets einer Schnittstelle eines Netzwerkgeräts ab. Bei diesen Zählern ist der Absolutwert nicht relevant; interessant ist die Veränderung über die Zeit, sodass die Felder Result für diese beiden OIDs die Werte selbst sowie alle String-Werte (die von dieser OID ohnehin nicht zurückgegeben werden) unterdrücken.

In der Unit-Definition für das Ergebnis der ersten OID sind die Einheiten für Wert und String-Wert entsprechend ausgegraut:

Es wird ein Divisor angegeben, um die Ausgabe in kBit/s umzurechnen.

byte/s → kBit/s
kbit = byte / 1000 * 8
kbit = byte / (1000 / 8)
kbit = byte / 125

Die dritte OID fragt den ifOperStatus der Netzwerkschnittstelle ab, der vom SNMP-Agenten als String zurückgegeben wird (nicht als String-Objekt an sich, aber die Ausgabe lautet z. B.: up(1)). Dies ist ersichtlich, wenn man die Schaltfläche Browse online mit der OID .iso.org.dod.internet.mgmt.mib-2.interfaces.ifTable.ifEntry.ifOperStatus als Root verwendet:

Da numerische Werte von der SKOOR Engine schneller verarbeitet werden, ist es in der Regel besser, den bekannten String mithilfe des Feldes Map string to value in einen numerischen Wert umzuwandeln:

Das bedeutet, dass das an den Server gesendete Ergebnis ein Wert und kein String mehr ist, sodass man string values und diff values unterdrücken kann.

Die Unit-Definition für das Ergebnis der dritten OID wird wie folgt angegeben:

Die Ergebnisse werden anschließend im Abschnitt Values angezeigt:

Wenn eine der definierten OIDs einen Fehler erzeugt, wird die Fehlermeldung dieser OID angezeigt und der gesamte Job schlägt fehl. Alle nachfolgenden OIDs werden nicht verarbeitet, wenn eine OID fehlschlägt:

SNMP Werte und Alarm Limits

Wert / Alarm Limit

Beschreibung

Value1-n

Benutzerdefinierter numerischer Wert, definiert über die Schaltfläche Unit im Result-Bereich der OID.

Diff value1-n

Benutzerdefinierter numerischer Diff-Wert, definiert über die Schaltfläche Unit im Result-Bereich der OID.

String value1-n

Benutzerdefinierter String-Wert, definiert über die Schaltfläche Unit im Result-Bereich der OID.

Error code

Generischer Job-Fehlercode (siehe Abschnitt Job-Fehlercodes)

SNMP Beispiele

Beispiel 1 - Auswahl von SNMP mib-2-Schnittstellen nach Beschreibung

Es ist möglich, die Schnittstellennummer automatisch anhand ihrer Beschreibung auszuwählen. Dies kann nützlich sein, wenn sich die Anzahl der Schnittstellen eines Routers ändern kann. Dann muss es möglich sein, die Schnittstelle anhand ihrer Beschreibung auszuwählen.

Wir möchten die OID

   .iso.org.dod.internet.mgmt.mib-2.interfaces.ifTable.ifEntry.ifInOctets.<interface id>

nachschlagen, um die Anzahl der Oktette zu ermitteln, die eingehend über die Schnittstelle VLAN 10 übertragen wurden. Dazu suchen wir zuerst nach der Schnittstellenbeschreibung unterhalb von .iso.org.dod.internet.mgmt.mib-2.interfaces.ifTable.ifEntry.ifDescr:

   

und stellen fest, dass die Beschreibung wie folgt lautet:

em0_vlan10

Ersetzen Sie nun den numerischen Index nach ifInOctets durch den String $em0_vlan10$ und verwenden Sie dies als Request OID:

   .iso.org.dod.internet.mgmt.mib-2.interfaces.ifTable.ifEntry.ifInOctets.$em0_vlan10$

Verwenden Sie als Resolve OID

   .iso.org.dod.internet.mgmt.mib-2.interfaces.ifTable.ifEntry.ifDescr

Bei der Suche nach einem passenden Beschreibungs-String wird zwischen Groß- und Kleinschreibung unterschieden. Der Job merkt sich den letzten Index. Wenn sich die Nummer geändert hat, werden die Beschreibungen erneut gescannt.