Externe Überwachung
VergeOS unterstützt kein SNMP. Dieser Leitfaden behandelt die unterstützten Wege für die externe Überwachung — den Prometheus-Exporter (ioMetrics), die REST-API und IPMI — sowie SNMP-first-Tools wie SolarWinds.
Überblick
Diese Seite beschreibt, wie VergeOS mit externen Überwachungs- und Observability-Plattformen integriert wird. VergeOS ist API-first und stellt Plattformzustand, Leistung und Hardware-Sensordaten über drei unterstützte Pfade bereit.
SNMP wird nicht unterstützt
VergeOS enthält keinen SNMP-Agenten, keine MIB und keinen Trap-Mechanismus. SNMP wurde Ende der 1980er Jahre für die Verwaltung von Hardware-Netzwerkgeräten wie Routern, Switches und Druckern entwickelt, nicht für moderne softwaredefinierte Plattformen. VergeOS ist API-first: Jede Metrik und Ressource, die ein SNMP-Agent bereitstellen würde, ist bereits über die REST API und den Prometheus Exporter verfügbar, die über standardmäßiges HTTP umfangreichere strukturierte Daten liefern. Dies spiegelt den breiteren Branchenwandel wider, wobei Microsoft den SNMP-Dienst in Windows Server 2012 abgekündigt hat und Cloud-native sowie Hypervisor-Plattformen den Prometheus-Expositionsstandard übernehmen. Wenn Ihr altes Überwachungstool SNMP erfordert, siehe SNMP-First-Tools unten die verfügbaren Workarounds.
Unterstützte Überwachungspfade
vSAN-, Cluster- und Knotenmetriken
Empfohlener Ausgangspunkt für die meisten Umgebungen
Benutzerdefinierte Collector, Abfragen beliebiger Ressourcen
Tool-spezifische Integrationen, skriptbasierte Prüfungen
Prometheus Exporter (ioMetrics)
Der VergeOS Prometheus Exporter (ioMetrics) ist der empfohlene Weg für Metriken auf Plattformebene. Er erfasst vSAN-Tier-, Cluster- und Knoten-Metriken aus VergeOS und stellt sie im standardmäßigen Prometheus-Format bereit, sodass sie von Prometheus, Grafana, VictoriaMetrics oder jedem Prometheus-kompatiblen System abgefragt werden können.
Warum dies der empfohlene Weg ist
Vom Hersteller — gepflegt in der Organisation verge-io
Standardbasiert — jedes Prometheus-kompatible Überwachungstool kann die Ausgabe verarbeiten
Siehe die Prometheus Exporter (ioMetrics) Seite für den Produktüberblick, die exponierten Metriken und Links zum Open-Source-Projekt.
REST API
Die VergeOS REST API stellt jede Ressource bereit, die die UI lesen kann, und ist damit der richtige Weg für benutzerdefinierte Collector, skriptbasierte Gesundheitsprüfungen oder Integrationen mit Tools, die kein Prometheus sprechen.
Authentifizierung
Externe Überwachungs-Collector laufen dauerhaft und sollten sich mit einem API-Schlüssel statt mit einem Sitzungstoken authentifizieren. API-Schlüssel werden pro Benutzer erstellt und können auf IPs beschränkt sowie mit einem Ablaufdatum versehen werden. Siehe API-Schlüssel für die Einrichtung und den API-Leitfaden für die vollständige Liste der unterstützten Authentifizierungsmethoden.
Swagger-Dokumentation
Die vollständige, versionsgenaue API-Referenz ist in VergeOS verfügbar:
Klicken Sie auf das Benutzersymbol oben rechts in der VergeOS-Benutzeroberfläche.
Wählen Sie System.
Wählen Sie API-Dokumentation.
Die Swagger-Seite listet jede Tabelle und jeden Vorgang auf, mit Beispielen, die direkt gegen das System ausgeführt werden können.
Wo Sie beginnen sollten
Hintergrund zu HTTP-Konventionen, Filterung, Sortierung und Beispielanfragen finden Sie im API-Leitfaden in der Wissensdatenbank.
Wann die REST API für die Überwachung verwendet werden sollte
Das Überwachungstool unterstützt HTTP-Abfragen, aber kein Prometheus
Eine bestimmte Metrik oder Ressource wird vom Prometheus Exporter nicht bereitgestellt
Ein benutzerdefinierter Collector wird benötigt, um ihn in eine interne Observability-Plattform zu integrieren
IPMI
Für Hardwarezustand und Sensordaten pro Knoten — Temperatur, Lüfterdrehzahl, Spannung, Leistungsaufnahme, Hardwarefehler — stellt VergeOS die IPMI-Schnittstelle des Knotens direkt bereit.
Navigieren Sie zu Infrastruktur > Knoten im oberen Menü.
Doppelklicken Sie auf den gewünschten Knoten, um das Knoten-Dashboard zu öffnen.
Unter dem IPMI Untermenü klicken Sie auf Verbinden um die IPMI-Weboberfläche in einem neuen Tab zu öffnen, oder Testen um die Verbindung von VergeOS aus zu überprüfen.
Zum Konfigurieren gespeicherter IPMI-Anmeldedaten und zum Testen der Verbindung siehe die IPMI Seite.
SNMP-First-Tools
Tools wie SolarWinds, LogicMonitor, PRTG, und Nagios werden häufig so konfiguriert, dass sie Infrastruktur über SNMP überwachen. VergeOS bietet keine sofort einsatzbereite Integration für diese Tools, da es keinen SNMP-Agenten gibt, auf den sie ausgerichtet werden könnten.
Prüfen Sie zuerst die native Prometheus-Unterstützung
Einige dieser Plattformen nehmen Prometheus-Metriken inzwischen nativ auf — LogicMonitor (OpenMetrics-Datenquelle) und SolarWinds Observability (Prometheus-Integration). Wenn Ihre Plattform eine davon ist, richten Sie sie auf den Prometheus Exporter aus und überspringen Sie den Rest dieses Abschnitts. Die beiden folgenden Optionen decken Tools ab, die kein Prometheus sprechen — einschließlich der lokalen SolarWinds Platform / SAM, PRTG, und Nagios.
Option 1 — Benutzerdefinierter REST-Collector
Die meisten Enterprise-Überwachungsplattformen erlauben benutzerdefinierte HTTP/REST-Collector:
SolarWinds
API-Abfrage (SAM)
LogicMonitor
Skriptbasierte Datenquelle (Groovy / HTTP)
PRTG
HTTP XML/REST benutzerdefinierter Sensor
Nagios
check_http / benutzerdefiniertes Plugin
Richten Sie den Collector auf die VergeOS REST API aus, authentifizieren Sie sich gemäß dem API-Leitfadenund parsen Sie die JSON-Antwort. Dies ist der Weg mit dem geringsten Overhead — kein Zwischenprozess, der gewartet werden muss, und der Collector spricht direkt mit der Quelle der Wahrheit.
Option 2 — Prometheus-zu-SNMP-Bridge
Wenn das Überwachungstool nur SNMP spricht und ein benutzerdefinierter Collector keine Option ist, ist das Community-Muster, das Prometheus Exporter und davor eine Prometheus-zu-SNMP-Bridge zu platzieren. Die Bridge stellt Prometheus-Metriken erneut als SNMP-OIDs bereit, die ein SNMP-Poller abfragen kann.
Nicht von Verge unterstützt
Prometheus-zu-SNMP-Bridges sind Community-Projekte und werden von Verge nicht gebaut, getestet oder unterstützt. Wir empfehlen keine bestimmte Bridge — die Wahl hängt davon ab, welcher Teilmenge der Prometheus-Metriken erneut bereitgestellt werden muss und wie das nachgelagerte Tool SNMP verarbeitet. Betrachten Sie diesen Weg als Übergangslösung, nicht als langfristige Integration.
Einen Weg wählen
Neue Überwachungsbereitstellung, keine bestehende Tool-Bindung
Prometheus Exporter + Grafana
Bestehender Prometheus / Grafana / VictoriaMetrics-Stack
Überwachungstool, das HTTP abfragt, aber kein Prometheus
REST API benutzerdefinierter Collector
Hardwarezustand (Temperatur, Lüfter, Stromversorgung)
SolarWinds / LogicMonitor / PRTG / Nagios (SNMP-first)
Benutzerdefinierter REST-Collector bevorzugt, Prometheus-zu-SNMP-Bridge als Fallback
Nächste Schritte
Prometheus Exporter (ioMetrics) — Produktüberblick und Links zum Open-Source-Projekt
API-Leitfaden — Authentifizierung, HTTP-Konventionen und Beispielanfragen
IPMI — Verbindungsprüfung, Verwaltung von Anmeldedaten und Zugriff auf die IPMI-Weboberfläche
Dokumentation und Ressourcen
Open-Source-Prometheus-Exporter für VergeOS
Offizielle Prometheus-Dokumentation
Dashboards auf Basis von Prometheus-Metriken erstellen
Zuletzt aktualisiert
War das hilfreich?