Dokumentation

SNMP-Spaziergang

Funktion

Ruft eine oder mehrere SNMP-OIDs rekursiv ab und überträgt die Ausgabe in eine Flatfile auf dem Kollektor

Alarmierung

Zeilenanzahl, Übertragungszeit

Siehe allgemeine Informationen zu SNMP unterhalb des Kapitels „SNMP-Job“.

SNMP-Walk-Details

Der SNMP-Walk durchläuft den definierten MIB-Baum nach unten und speichert dessen Inhalt in einer Datei auf dem für den SNMP-Walk-Job konfigurierten Kollektor im folgenden Verzeichnis: /var/opt/run/eranger/kollektor/tmp/snmp_walk. Das Verzeichnis muss manuell angelegt werden, falls es nicht existiert, und der Benutzer „eranger“ muss über Schreibrechte darauf verfügen. Da es sich um ein Unterverzeichnis des Standard-Parse-Verzeichnisses handelt, ist es möglich, die vom SNMP-Walk abgerufene Datei direkt mit einem nachfolgenden „Parsefile“-Job zu analysieren.

SNMP-Walk-Parameter

Der Eingabebereich „Authentifizierung“ wird nur angezeigt, wenn SNMP Version 3 ausgewählt ist.

Parameter

Beschreibung

UDP-Port

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

Wiederholversuche

Anzahl der Wiederholungsversuche, falls die Anfrage fehlschlägt. Standardmäßig sind 2 Wiederholungsversuche vorgesehen.

Zeitlimit

Wählen Sie das Timeout für die Anfrage aus. Auf den meisten Geräten werden SNMP-Anfragen mit niedriger Priorität behandelt; wählen Sie daher ein ausreichend langes Timeout. Standardwert ist 2 s.

Version

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

Version 1
, Version 2c
, Version 3

Übertragung (Bulk-Modus)

Verwendet intern den Befehl „snmpbulkwalk“ anstelle von „snmpwalk“. Beide sollten zu denselben Ergebnissen führen. Manchmal liefert „snmpbulkwalk“ die Ausgabe jedoch etwas schneller.

Sicherheitsstufe

Die Sicherheitsstufe legt fest, wie die SNMP-Anfrage gesendet wird. Diese Option ist nur verfügbar, wenn SNMP v3 verwendet wird. Folgende Optionen stehen zur Auswahl:
Keine Authentifizierung, keine Verschlüsselung
; Authentifizierung, keine Verschlüsselung
; Authentifizierung, Verschlüsselung

Benutzername

Für die Authentifizierung, nur sichtbar bei Verwendung von SNMP v3.

Authentifizierungs-Passphrase

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

Authentifizierungsprotokoll

Protokoll für die Authentifizierung, nur sichtbar bei Verwendung von SNMP mit Authentifizierung. Derzeit verfügbare Optionen sind MD5 oder SHA. Die Standardeinstellung ist MD5.

Passphrase für den Datenschutz

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

Datenschutzprotokoll

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 verschiedene Ebenen des SNMP-Zugriffs, zum Beispiel: READ ONLY oder READ/WRITE. Jede dieser Zugriffsebenen verfügt in der Regel über eine eigene Community-Zeichenkette. Zum Lesen von Daten muss lediglich die READ-Community bekannt sein, die in der Regel „public“ lautet.

Anfrage-OID

Geben Sie die MIB-OID (Management Information Base) für die Anfrage ein. Ist die OID unbekannt, kann sie über den Online-Browser gesucht werden. Zusätzliche OIDs (bis zu 4 OIDs) können in einem einzelnen SNMP-Auftrag angefordert werden, indem Sie auf die Schaltfläche „+“ neben der Schaltfläche „Durchsuchen“ klicken. Werden mehr als eine OID eingegeben, wird die Ausgabe aller OIDs nacheinander an dieselbe Ausgabedatei angehängt.

Dateiname

Der Name der Datei, in die die Ausgabe von „SNMP Walk“ geschrieben werden soll. Die Dateiendung .txt wird automatisch angehängt. Die Datei wird im Verzeichnis /var/opt/run/eranger/Kollektor/tmp/snmp_walk angelegt. Das Verzeichnis muss manuell angelegt werden, falls es noch nicht existiert, und der Benutzer „eranger“ muss über Schreibrechte für dieses Verzeichnis verfügen. Wird kein Dateiname angegeben, erstellt die SKOOR Engine automatisch einen Dateinamen, der die IP-Adresse und eine Nummer enthält.

Über die Dropdown-Liste „Tags“ können vordefinierte Variablen in die obigen Felder eingegeben werden, z. B. $NAME$ für den Namen des Jobs.

Es kann mehr als eine OID angegeben werden. Um weitere OIDs hinzuzufügen, klicken Sie auf die Schaltfläche „+“ neben der Schaltfläche „Online durchsuchen“:

Alle konfigurierten Request-OIDs werden in derselben Ausgabedatei zusammengefügt.

Ist eine der OIDs nicht zugänglich, wird keine Ausgabedatei generiert.

SNMP-Walk-Werte und Alarm Limits

Im Abschnitt „Werte“ des Auftrags wird ein Link zur Ausgabedatei angezeigt, die im Browser angezeigt werden kann.

Wert / Alarm Limit

Beschreibung

Zeilenanzahl

Die Anzahl der Zeilen in der resultierenden Ausgabedatei.

Übertragungszeit

Die Zeit, die für die Übertragung der Ergebnisse vom SNMP-Agenten benötigt wurde (in ms)

Fehlercode

Generischer Job-Fehlercode (siehe Abschnitt „Job-Fehlercodes“)

Beispiele für SNMP-Walk

Beispiel 1 – Durchlaufen der System-MIB auf einem Netzwerkgerät

Anfrage an OID 1

.iso.org.dod.internet.mgmt.mib-2.system

Ausgabe 1

Der Inhalt der Ausgabedatei lautet:

RFC1213-MIB::sysDescr.0 = STRING: "Firewall fw5.junisphere.local 2.2.5-RELEASE nanobsd FreeBSD 10.1-RELEASE-p24 i386"
RFC1213-MIB::sysObjectID.0 = OID: RFC1155-SMI::enterprises.12325.1.1.2.1.1
DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (392862223) 45 days, 11:17:02.23
RFC1213-MIB::sysContact.0 = STRING: "support@skoor.com"
RFC1213-MIB::sysName.0 = STRING: "fw5.skoor.local"
RFC1213-MIB::sysLocation.0 = STRING: "Glattzentrum, Wallisellen"
RFC1213-MIB::sysServices.0 = INTEGER: 76
SNMPv2-MIB::sysORLastChange.0 = Timeticks: (27) 0:00:00.27
SNMPv2-MIB::sysORID.1 = OID: RFC1155-SMI::enterprises.12325.1.1.1.10.2
SNMPv2-MIB::sysORID.2 = OID: RFC1155-SMI::enterprises.12325.1.1.1.10.3
SNMPv2-MIB::sysORID.3 = OID: SNMPv2-MIB::snmpMIB
SNMPv2-MIB::sysORID.4 = OID: RFC1155-SMI::enterprises.12325.1.1
SNMPv2-MIB::sysORID.5 = OID: IF-MIB::ifMIB
SNMPv2-MIB::sysORID.6 = OID: IP-MIB::ipMIB
SNMPv2-MIB::sysORID.7 = OID: TCP-MIB::tcpMIB
SNMPv2-MIB::sysORID.8 = OID: UDP-MIB::udpMIB
SNMPv2-MIB::sysORID.9 = OID: IP-FORWARD-MIB::ipForward
SNMPv2-MIB::sysORID.10 = OID: RFC1155-SMI::enterprises.12325.1.2
SNMPv2-MIB::sysORID.11 = OID: HOST-RESOURCES-MIB::host
SNMPv2-MIB::sysORDescr.1 = STRING: udp transport mapping
SNMPv2-MIB::sysORDescr.2 = STRING: lsock transport mapping
SNMPv2-MIB::sysORDescr.3 = STRING: The MIB module for SNMPv2 entities.
SNMPv2-MIB::sysORDescr.4 = STRING: The MIB module for the Begemot SNMPd.
SNMPv2-MIB::sysORDescr.5 = STRING: The MIB module to describe generic objects for network interface sub-layers.
SNMPv2-MIB::sysORDescr.6 = STRING: The MIB module for managing IP and ICMP implementations, but excluding their management of IP routes.
SNMPv2-MIB::sysORDescr.7 = STRING: The MIB module for managing TCP implementations.
SNMPv2-MIB::sysORDescr.8 = STRING: The MIB module for managing UDP implementations.
SNMPv2-MIB::sysORDescr.9 = STRING: The MIB module for the display of CIDR multipath IP Routes.
SNMPv2-MIB::sysORDescr.10 = STRING: The MIB for the NetGraph access module for SNMP.
SNMPv2-MIB::sysORDescr.11 = STRING: The MIB module for Host Resource MIB (RFC 2790).
SNMPv2-MIB::sysORUpTime.1 = Timeticks: (0) 0:00:00.00
SNMPv2-MIB::sysORUpTime.2 = Timeticks: (0) 0:00:00.00
SNMPv2-MIB::sysORUpTime.3 = Timeticks: (1) 0:00:00.01
SNMPv2-MIB::sysORUpTime.4 = Timeticks: (1) 0:00:00.01
SNMPv2-MIB::sysORUpTime.5 = Timeticks: (1) 0:00:00.01
SNMPv2-MIB::sysORUpTime.6 = Timeticks: (1) 0:00:00.01
SNMPv2-MIB::sysORUpTime.7 = Timeticks: (1) 0:00:00.01
SNMPv2-MIB::sysORUpTime.8 = Timeticks: (1) 0:00:00.01
SNMPv2-MIB::sysORUpTime.9 = Timeticks: (1) 0:00:00.01
SNMPv2-MIB::sysORUpTime.10 = Timeticks: (27) 0:00:00.27
SNMPv2-MIB::sysORUpTime.11 = Timeticks: (27) 0:00:00.27

Beispiel 2 – Durchlaufen der Interfaces-MIB auf einem Netzwerkgerät

Anfrage OID 1

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

Dateiname

$DEVICE_ADDRESS$_interfaces

Ausgabe 2

Die Ausgabedatei erhält einen Namen, der aus der IP-Adresse des Geräts besteht, z. B. 192.168.0.2_interfaces.txt. Sie enthält die Eingangs- und Ausgangs-Oktette sowie die Fehler und Zustände der Schnittstellen und kann anschließend mit einem einzigen Parsefile-Auftrag analysiert werden.

IF-MIB::ifDescr.1 = STRING: MS TCP Loopback interface
IF-MIB::ifDescr.2 = STRING: SonicWALL VPN Adapter 
IF-MIB::ifDescr.3 = STRING: AppGate Tunneling Adapter 
IF-MIB::ifDescr.65541 = STRING: Realtek RTL8139
IF-MIB::ifSpeed.1 = Gauge32: 10000000
IF-MIB::ifSpeed.2 = Gauge32: 10000000
IF-MIB::ifSpeed.3 = Gauge32: 100000000
IF-MIB::ifSpeed.65541 = Gauge32: 100000000
IF-MIB::ifPhysAddress.1 = STRING: 
IF-MIB::ifPhysAddress.2 = STRING: 0:60:73:e1:be:8a
IF-MIB::ifPhysAddress.3 = STRING: 9a:7c:d6:36:81:ce
IF-MIB::ifPhysAddress.65541 = STRING: 0:10:a7:13:64:75
IF-MIB::ifOperStatus.1 = INTEGER: up(1)
IF-MIB::ifOperStatus.2 = INTEGER: up(1)
IF-MIB::ifOperStatus.3 = INTEGER: down(2)
IF-MIB::ifOperStatus.65541 = INTEGER: up(1)
IF-MIB::ifInOctets.1 = Counter32: 84968069
IF-MIB::ifInOctets.2 = Counter32: 2332180
IF-MIB::ifInOctets.3 = Counter32: 0
IF-MIB::ifInOctets.65541 = Counter32: 1657249881
IF-MIB::ifInErrors.1 = Counter32: 0
IF-MIB::ifInErrors.2 = Counter32: 0
IF-MIB::ifInErrors.3 = Counter32: 0
IF-MIB::ifInErrors.65541 = Counter32: 0
IF-MIB::ifOutOctets.1 = Counter32: 84968069
IF-MIB::ifOutOctets.2 = Counter32: 2250784
IF-MIB::ifOutOctets.3 = Counter32: 0
IF-MIB::ifOutOctets.65541 = Counter32: 2070937977


Zurück
Agent Service
Weiter
Agent Prozess