> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/automate-protect-and-extend/de/integrationen-und-apis/external-monitoring.md). # Externe Überwachung ## Ü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. {% hint style="warning" %} **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](#snmp-first-tools) unten die verfügbaren Workarounds. {% endhint %} ### Unterstützte Überwachungspfade | Pfad | Verwendet für | Zielgruppe | | ----------------------------------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------- | | [Prometheus Exporter (ioMetrics)](#prometheus-exporter-iometrics) | vSAN-, Cluster- und Knotenmetriken | Empfohlener Ausgangspunkt für die meisten Umgebungen | | [REST API](#rest-api) | Benutzerdefinierte Collector, Abfragen beliebiger Ressourcen | Tool-spezifische Integrationen, skriptbasierte Prüfungen | | [IPMI](#ipmi) | Hardwarezustand und Sensoren pro Knoten | Hardwareüberwachung außerhalb von VergeOS | *** ## 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)](/automate-protect-and-extend/de/integrationen-und-apis/prometheus-exporter.md) 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](/automate-protect-and-extend/de/gemeinsame-admin-oberflachen/api-keys.md) für die Einrichtung und den [API-Leitfaden](/knowledge-base/de/automation-api/verge-api-guide.md) für die vollständige Liste der unterstützten Authentifizierungsmethoden. ### Swagger-Dokumentation Die vollständige, versionsgenaue API-Referenz ist in VergeOS verfügbar: 1. Klicken Sie auf das **Benutzersymbol** oben rechts in der VergeOS-Benutzeroberfläche. 2. Wählen Sie **System**. 3. 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. {% hint style="success" %} **Wo Sie beginnen sollten** Hintergrund zu HTTP-Konventionen, Filterung, Sortierung und Beispielanfragen finden Sie im [API-Leitfaden](/knowledge-base/de/automation-api/verge-api-guide.md) in der Wissensdatenbank. {% endhint %} ### 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. 1. Navigieren Sie zu **Infrastruktur > Knoten** im oberen Menü. 2. Doppelklicken Sie auf den gewünschten Knoten, um das Knoten-Dashboard zu öffnen. 3. 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. {% hint style="info" %} **Nur Hardware** IPMI stellt den **physischen Hardware** Zustand eines Host-Knotens bereit — nicht die Metriken der Anwendungsebene von VergeOS. Die meisten Überwachungsplattformen enthalten bereits IPMI-Collector, die die BMCs der Knoten direkt abfragen können, parallel zu den oben genannten Pfaden des Prometheus Exporters und der REST API. {% endhint %} Zum Konfigurieren gespeicherter IPMI-Anmeldedaten und zum Testen der Verbindung siehe die [IPMI](/run-the-platform/de/systemadministration/ipmi.md) 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. {% hint style="success" %} **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](#prometheus-exporter-iometrics) 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**. {% endhint %} ### Option 1 — Benutzerdefinierter REST-Collector Die meisten Enterprise-Überwachungsplattformen erlauben benutzerdefinierte HTTP/REST-Collector: | Plattform | Mechanismus | | ------------ | ------------------------------------------ | | 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-Leitfaden](/knowledge-base/de/automation-api/verge-api-guide.md)und 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](#prometheus-exporter-iometrics) 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. {% hint style="warning" %} **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. {% endhint %} *** ## Einen Weg wählen | Szenario | Empfohlener Weg | | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Neue Überwachungsbereitstellung, keine bestehende Tool-Bindung | [Prometheus Exporter](#prometheus-exporter-iometrics) + Grafana | | Bestehender Prometheus / Grafana / VictoriaMetrics-Stack | [Prometheus Exporter](#prometheus-exporter-iometrics) | | Überwachungstool, das HTTP abfragt, aber kein Prometheus | [REST API](#rest-api) benutzerdefinierter Collector | | Hardwarezustand (Temperatur, Lüfter, Stromversorgung) | [IPMI](#ipmi) | | SolarWinds / LogicMonitor / PRTG / Nagios (SNMP-first) | [Benutzerdefinierter REST-Collector](#option-1-custom-rest-collector) bevorzugt, [Prometheus-zu-SNMP-Bridge](#option-2-prometheus-to-snmp-bridge) als Fallback | ## Nächste Schritte * [Prometheus Exporter (ioMetrics)](/automate-protect-and-extend/de/integrationen-und-apis/prometheus-exporter.md) — Produktüberblick und Links zum Open-Source-Projekt * [API-Leitfaden](/knowledge-base/de/automation-api/verge-api-guide.md) — Authentifizierung, HTTP-Konventionen und Beispielanfragen * [IPMI](/run-the-platform/de/systemadministration/ipmi.md) — Verbindungsprüfung, Verwaltung von Anmeldedaten und Zugriff auf die IPMI-Weboberfläche ## Dokumentation und Ressourcen | Ressource | Beschreibung | | ----------------------------------------------------------------------------- | ------------------------------------------------------ | | [vergeos-exporter](https://github.com/verge-io/vergeos-exporter) | Open-Source-Prometheus-Exporter für VergeOS | | [Prometheus-Dokumentation](https://prometheus.io/docs/introduction/overview/) | Offizielle Prometheus-Dokumentation | | [Grafana-Dokumentation](https://grafana.com/docs/) | Dashboards auf Basis von Prometheus-Metriken erstellen | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/automate-protect-and-extend/de/integrationen-und-apis/external-monitoring.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.