SNMP-Probe-Parameter
Dies ist die Liste der Parameter, die an SNMP-Probes übergeben werden kann.
Anweisungen zum Konfigurieren der Sondenparameter finden Sie unter Probe-Parameter festlegen .
| Parameter | Beschreibung | Standardwert | ||||||
|---|---|---|---|---|---|---|---|---|
| oid_spec_list | Eine Liste mit OID-Spezifikationen, eine pro Zeile. Jede Spezifikation muss eines der folgenden beiden Formate aufweisen:
{OID Child} bezieht sich auf eine kommagetrennte Liste von untergeordneten Knoten in den Einträgen für die angegebene Tabelle. Beispiel: „ifEntry.ifIndex,ifEntry.ifDescr,ifEntry.ifType“ sind untergeordnete OID-Elemente der Tabelle „iso.org.dod.internet.mgmt.mib-2.interfaces.ifTable“. Der Einfachheit halber kann das Präfix des Tabelleneintrags weggelassen werden. (Die vorherigen untergeordneten Elemente können als „ifIndex,ifDescr,ifType“ angegeben werden.) Alle untergeordneten Elemente können einen Filterqualifizierer in Klammern einschließen. Beispiel: Das untergeordnete Element „entPhysicalContainedIn(=0)“ gibt zurückgegebene Tabelleneinträge nur an, wenn der Wert von „entPhysicalContainedIn“ gleich 0 ist. Die im Ausdruck unterstützten Operatoren lauten wie folgt:
Wenn mehrere untergeordnete Elemente über einen Filterausdruck verfügen, wird der Eintrag bei einer Übereinstimmung mit einem der untergeordneten Elemente gelesen. Alle Inhalte einschließlich und hinter „//“ werden ignoriert (Kommentare). Alle OIDs, die nicht mit „1.3.6.1“ oder „iso.org.dod.internet“ beginnen, beginnen der Einfachheit halber automatisch mit „1.3.6.1“. |
erforderlich | ||||||
| Quelle | IP-Adresse oder Hostname des Geräts, auf dem SNMP abgefragt werden soll | erforderlich | ||||||
| index | Der nach der Community-Zeichenfolge anzuwendende Index zur Indizierung der Community-Zeichenfolge im Cisco-Stil (für VLAN-Abfrage) | 0 | ||||||
| credential_id | Die sys_id einer bestimmten Anmeldeinformation, die bevorzugt zu verwenden ist. Dieser Parameter ist nur zum internen Gebrauch bestimmt und wird nicht unterstützt. | keine | ||||||
| credential_tag | Das Anmeldeinformations-Tag, das verwendet werden muss. Dieser Parameter ist nur zum internen Gebrauch bestimmt und wird nicht unterstützt. | keine | ||||||
| timeout | Zeitüberschreitungswert (in Millisekunden) für die Wartezeit auf eine Antwort anstelle des Standardwerts. Sie können diesen Parameter verwenden, um den Konfigurationsparameter mid.snmp.request.timeout des SNMP-MID Servers zu überschreiben. Hinweis: Wenn use_getbulk auf true festgelegt ist, gilt der Zeitüberschreitungswert für eine einzelne GETBULK-Anforderung. |
1500 | ||||||
| established_session_timeout | Intervall (in Millisekunden), über das auf eine Antwort gewartet wird, nachdem mindestens eine Antwort empfangen wurde. Längere Werte können zur Erfassung vollständiger und genauer Daten nützlich sein. Sie können diesen Parameter verwenden, um den Konfigurationsparameter mid.snmp.session.timeout des SNMP-MID Servers zu überschreiben. | 500 | ||||||
| debug | Aktiviert die Debug-Protokollierung Legen Sie diesen Parameter für den Debug-Modus auf „true“ fest. | false | ||||||
| request_interval | Intervall (in Millisekunden) zwischen aufeinanderfolgenden Anforderungen für eine OID, wenn keine Antwort empfangen wurde, bis der Zeitüberschreitungswert (oder established_session_timeout) erreicht wird. Wenn dieser Wert mindestens auf den Wert für die Zeitüberschreitung (oder established_session_timeout) festgelegt ist, wird nur eine einzelne Anforderung für eine bestimmte OID gesendet. Wenn Sie den Wert für die Zeitüberschreitung (oder established_session_timeout) ändern, passen Sie request_interval gleichzeitig an, um zu vermeiden, dass zu viele oder zu wenige Anforderungen für dieselbe OID gesendet werden, je nachdem, was für eine bestimmte Umgebung angemessen ist. | 400 | ||||||
| request_delay | Intervall (in Millisekunden) zwischen dem Empfang einer Antwort und der Übertragung der nächsten Anforderung. Der Standardwert ist 0 (keine Verzögerung). Dieser Wert kann festgelegt werden, um die Gesamtrate einer SNMP-Abfrage zu verlangsamen. | 0 | ||||||
| result_format | Gibt JSON-formatierte Nutzlasten für die folgenden Probes zurück:
Warnung: Die Verwendung dieses Parameters mit anderen Probes führt zum Ausfall des Sensors. |
JSON | ||||||
| use_getbulk | Aktiviert die Verwendung von SNMP GETBULK-Anforderungen zum Abrufen von tabellarischen Daten von SNMP-Geräten, anstatt mehrere SNMP GETNEXT-Anforderungen zu verwenden. Für tabellarische Daten ist GETBULK effizienter. Unabhängig vom Anforderungstyp geben bestimmte Geräte möglicherweise keine Ergebnisse zurück, wenn sie mit anderen Aufgaben beschäftigt sind. Dieser Parameter wird zur Konfiguration auf Probe-Ebene verwendet. GETBULK kann auch für einen einzelnen MID Server oder global für alle MID Server festgelegt werden. Einstellungen werden in ihrer Prioritätsfolge aufgelistet:
Die Parameter established_session_timeout, request_interval, und request_delay werden ignoriert, wenn use_getbulk auf true festgelegt ist. Stattdessen ist der Parameter retries verfügbar. Die Konfiguration der Zeitüberschreitung ist identisch mit use_getscalar. Standardmäßig verwenden die folgenden Probes GETBULK-Anforderungen (Parameterwert gleich true).
Hinweis: Der timeout-Wert dieser Probes beträgt 5000. |
false | ||||||
| use_getscalar | Ermöglicht das vereinfachten Abrufen und Verarbeiten von skalaren Werten von SNMP-Geräten. Die Parameter established_session_timeout, request_interval und request_delay werden ignoriert, wenn use_getscalar auf true festgelegt ist. Stattdessen sind die Parameter retries und timeout verfügbar. Die Konfiguration der Zeitüberschreitung ist identisch mit use_getbulk. |
false | ||||||
| Wiederholungen | Die Anzahl der zusätzlichen Versuche, die Discovery unternimmt, um eine einzelne GETBULK-Anforderung (siehe use_getbulk) oder eine GETNEXT-Anforderung abzuschließen, wenn der Parameter use_getscalar auf true festgelegt ist. | 2 |