Hermetry kann Switches, Router, USVs, Server, Drucker und andere Geräte mit einem SNMP-Agent auslesen. Der Poller der Plattform fragt beim Agent die OIDs ab, die Ihr Geräteprofil zuordnet, und speichert die Antworten als Telemetrie und Attribute des Geräts. Eine MIB-Datei wird nicht benötigt: Sie ordnen numerische OIDs Schlüsseln zu.
Unterstützte Funktionen
| Element | Unterstützung |
|---|---|
| Versionen | SNMPv3 (empfohlen) und SNMPv2c (ausgeschaltet, bis ein Workspace-Admin es einschaltet) |
| SNMPv3-Sicherheit | authPriv (Standard) oder authNoPriv; noAuthNoPriv wird nicht angeboten |
| SNMPv3-Authentifizierung | SHA-256 (Standard), SHA-512, SHA-384, SHA-224, SHA-1 (veraltet) |
| SNMPv3-Verschlüsselung | AES-128 |
| Wo der Poller läuft | In der Cloud. Der Agent muss unter einer öffentlichen Adresse erreichbar sein, direkt oder über Ihr VPN oder Ihren Tunnel. |
| Traps | Werden nicht empfangen. Die Cloud hat keinen Trap-Listener. |
| Polling vor Ort durch ein lizenziertes Gateway | In Entwicklung |
| MIB-Dateien | Werden nicht verwendet. Nur numerische OIDs. |
Schritt 1: Profil anlegen
- Wählen Sie unter Geräteprofile die Option Neues Profil und als Transport SNMP. Die Online-Regel lautet Nur zuletzt gesehen.
- Öffnen Sie den Reiter SNMP des Profils und erstellen Sie die Zuordnung (Schritt 4). Die integrierten Vorlagen in der SNMP-Vorlagen-Referenz enthalten fertige OIDs und Schlüssel für gängige Geräte.
Schritt 2: Gerät und seinen Endpunkt anlegen
Legen Sie es an mit Geräte > Neues Gerät > Netzwerkgerät, wählen Sie das Protokoll SNMP und einen neuen Endpunkt. Die Schritte finden Sie unter Protokoll-Endpunkte. Die Felder des SNMP-Endpunkts:
| Feld | Standard | Hinweise |
|---|---|---|
| Agent | — | Hostname oder öffentliche IP-Adresse, unter der die Cloud den Agent erreicht |
| UDP-Port | 161 | 1 bis 65.535 |
| SNMP-Version | SNMPv3 (empfohlen) | Oder SNMPv2c (Community im Klartext) |
| Community | — | Nur v2c. Geheimnis, „Wird mit jeder Anfrage im Klartext gesendet.“ |
| Benutzer | — | Nur v3 |
| Sicherheitsstufe | Authentifizierung und Verschlüsselung (authPriv) | Oder Nur Authentifizierung (authNoPriv) |
| Authentifizierung | SHA-256 | Nur v3 |
| Authentifizierungspasswort | — | Nur v3. Geheimnis, mindestens 8 Zeichen |
| Verschlüsselung | AES-128 | v3 mit authPriv |
| Verschlüsselungspasswort | — | v3 mit authPriv. Geheimnis, mindestens 8 Zeichen |
| Kontextname | leer | Optional. „Die meisten Agents verwenden den leeren Kontext.“ |
| Wie die Cloud den Agent erreicht | Über ein VPN oder einen Tunnel (empfohlen) | Oder Direkt über das Internet |
Der Verbindungstest liest die System-Gruppe (sysDescr, sysObjectID, sysUpTime, sysName). Ein Agent, der weder sysUpTime noch sysObjectID beantwortet, lässt den Test fehlschlagen.
Warnungen, die bei einem Test angezeigt werden (sie lassen ihn nicht fehlschlagen): „SNMPv2c: Die Community-Zeichenkette wird im Klartext übertragen.“, „SNMPv2c direkt über das Internet: Die Community-Zeichenkette wird darüber im Klartext übertragen.“, „authNoPriv: Nachrichten sind signiert, aber nicht verschlüsselt.“, „SHA-1-Authentifizierung ist veraltet.“
Schritt 3 (nur v2c): SNMPv2c einschalten
SNMPv2c sendet seine Community unverschlüsselt, daher ist das Cloud-Polling per v2c für jeden Workspace ausgeschaltet, bis ein Admin es einschaltet. Das Speichern eines v2c-Endpunkts ist bei ausgeschaltetem Polling abgelehnt: „SNMPv2c-Polling aus der Cloud ist für diesen Workspace ausgeschaltet. Verwenden Sie SNMPv3, speichern Sie den Endpunkt ausgeschaltet oder lassen Sie einen Workspace-Admin v2c unten einschalten.“
- Wählen Sie unter der Ablehnung SNMPv2c für diesen Workspace einschalten.
- Lesen Sie die Warnung, aktivieren Sie „Ich verstehe, dass die Community-Zeichenkette im Klartext übertragen wird.“ und wählen Sie Einschalten.
- Speichern oder schalten Sie den Endpunkt erneut ein. Das Einschalten von v2c schaltet keinen Endpunkt automatisch ein.
Ein v2c-Endpunkt, der Direkt über das Internet erreicht wird, braucht außerdem eine eigene Bestätigung: „Ich verstehe, dass die Community-Zeichenkette im Klartext über das Internet übertragen wird“.
Wenn Sie Cloud-v2c erneut ausschalten, werden alle v2c-Endpunkte des Workspaces auf einmal ausgeschaltet; ihr Polling endet bei der nächsten Aktualisierung des Pollers. Ein späteres Einschalten aktiviert nichts von selbst: Schalten Sie jeden Endpunkt erneut ein. Beide Änderungen werden im Audit-Log protokolliert.
Schritt 4: OIDs Schlüsseln zuordnen
Der Reiter SNMP des Profils, SNMP-Zuordnung, sagt: „Welche OIDs die Plattform von den Geräten dieses Profils liest und unter welchen Schlüsseln sie sie speichert.“
Werte (Skalare): eine OID, ein Schlüssel, bei jeder Abfrage gelesen.
| Feld | Bedeutung |
|---|---|
| OID | Numerisch, zum Beispiel 1.3.6.1.2.1.1.3.0 für sysUpTime.0 |
| Schlüssel | Beginnt mit einem Buchstaben; Buchstaben, Ziffern und _ . : -, höchstens 96 Zeichen |
| Gespeichert als | Telemetrie (eine Zeitreihe) oder Attribut (der letzte Wert) |
| Typ | Automatisch, Gauge / Integer, Counter32, Counter64, TimeTicks (Sekunden), Text, Enumeration, IP-Adresse |
| Rate pro Sekunde | Bei Countern: die Änderung pro Sekunde. Die erste Messung nach einem Start wird übersprungen; ein 32-Bit-Überlauf wird behandelt. Nicht für Attribute. |
| Skalierung | Ein Multiplikator, zum Beispiel 0.1, um Zehntel in Einheiten umzurechnen. Nicht 0. |
| Einheit | Höchstens 16 Zeichen |
| Werte und ihre Bezeichnungen | Bei einer Enumeration eine Zuordnung pro Zeile: 1=up. Höchstens 64 Werte. |
Tabellen: durchlaufene Spalten. Jede Zeile der Tabelle wird zu einem Schlüssel pro Spalte, <Schlüssel>.<Zeile>.
| Feld | Bedeutung |
|---|---|
| Name | Eine Bezeichnung für Sie (zum Beispiel ifTable); wird von der Plattform nicht verwendet |
| Zeilen benannt nach | Der Zeilenindex (das OID-Suffix) oder Der Wert einer anderen Spalte (zum Beispiel ifName, sodass Schlüssel if.in_bps.eth0 lauten) |
| Zeilenobergrenze | 1 bis 256 Zeilen, Standard 64. Weitere Zeilen werden verworfen und gemeldet. |
| Spalten | 1 bis 16 Spalten, jede mit den oben genannten Wertfeldern. Spalten-OID ist die Spalte ohne den Zeilenindex. |
Abfrageeinstellungen: Timeout (ms) 200 bis 10.000 (Standard 2.000), Wiederholungen 0 bis 3 (Standard 1), Zeilen pro Bulk-Anfrage 1 bis 50 (Standard 10). „Das Abfrageintervall ist das erwartete Intervall des Profils“; siehe Abfrageintervalle, Backoff und Kontingent.
Wählen Sie Speichern. Die Zuordnung wird vor dem Speichern geprüft:
| Grenze | Wert |
|---|---|
| Werte | 200 Zeilen |
| Tabellen | 8 |
| Telemetrie-Schlüssel, die eine Zuordnung erzeugen kann (alle Tabellen voll) | 200 pro Gerät |
| Attribute | 50 pro Gerät |
| Doppelte Schlüssel oder OIDs | Nicht zulässig |
Der Editor zeigt „Diese Zuordnung erzeugt bis zu {telemetry} Telemetrie-Schlüssel und {attributes} Attribute pro Gerät.“ Senken Sie bei Überschreitung die Zeilenobergrenze einer Tabelle oder entfernen Sie Spalten.
Das Entfernen eines Werts oder einer Tabelle beendet das Lesen beim nächsten Abruf; gespeicherter Verlauf bleibt erhalten.
Testabfrage
Auf dem Reiter SNMP fragt Testabfrage ein Gerät dieses Profils mit den gespeicherten Zugangsdaten seines Endpunkts nach OIDs. Es wird nichts gespeichert.
- Wählen Sie das Gerät (eines, das über einen SNMP-Endpunkt verbunden ist).
- Wählen Sie System-Gruppe, Werte dieser Zuordnung oder geben Sie OIDs ein (numerisch, eine pro Zeile, höchstens die angezeigte Anzahl).
- Wählen Sie Testabfrage ausführen. Die Antwort listet OID, SNMP-Typ, Rohwert und das, worauf sie Zugeordnet zu abgebildet wird. Wählen Sie bei einer Zeile Zur Zuordnung hinzufügen, um sie hinzuzufügen (danach speichern).
Für eine Testabfrage wird die Berechtigung zur Verwaltung von Protokoll-Endpunkten benötigt. Testabfragen sind ratenbegrenzt („Zu viele Testabfragen. Versuchen Sie es in {seconds} s erneut.“).
Traps
Die Liste Traps auf dem Reiter SNMP dient der Trap-Zuordnung auf lizenzierten Gateways vor Ort, die sich in Entwicklung befindet. Die Cloud empfängt keine Traps. Um schnell benachrichtigt zu werden, fragen Sie die relevanten Status-OIDs ab und legen Sie eine Alarmregel für deren Schlüssel an.
Fehlerbehebung
| Testabfrage meldet | Lösung |
|---|---|
| „Der Agent hat nicht rechtzeitig geantwortet (prüfen Sie die Adresse, den Port sowie die Firewall oder das VPN).“ | Erlauben Sie den Adressen des Pollers UDP 161 (oder Ihren Port). |
| „Authentifizierung fehlgeschlagen (prüfen Sie Benutzer und Schlüssel).“ | Falscher v3-Benutzer oder falsches Authentifizierungspasswort. |
| „Der Agent konnte die Anfrage nicht entschlüsseln (prüfen Sie das Verschlüsselungspasswort).“ | Falsches Verschlüsselungspasswort. |
| „Der Agent kennt diesen SNMPv3-Benutzer nicht.“ | Legen Sie den Benutzer auf dem Agent an. |
| „Der Agent hat die Anfrage als außerhalb seines Zeitfensters abgelehnt.“ | Versuchen Sie es erneut; prüfen Sie die Uhrzeit des Agents. |
| „No such object“ / „No such instance“ | Der Agent besitzt diese OID nicht. Prüfen Sie die OID und den Zeilenindex. |
| „SNMPv2c aus der Cloud ist für dieses Konto deaktiviert. Ein Workspace-Administrator kann es aktivieren.“ | Siehe Schritt 3. |