For the complete documentation index, see llms.txt. This page is also available as Markdown.

Protokollverwaltung & Weiterleitung

VergeOS-Protokolltypen, 45-tägige Aufbewahrung in der Benutzeroberfläche, kontextbezogene Protokolle, Konfiguration der Weiterleitung an Remote-Syslog, SEL-Verwaltung und SMTP-Aktivitätsberichte.

Die Rolle von Logs im Betrieb von VergeOS

Logs sind die Audit-Trail- und Diagnosegrundlage jeder VergeOS-Umgebung. Sie protokollieren vom Benutzer ausgelöste Aktionen, automatisierte Systemereignisse, Hardware-Sensorwerte und Replikationsaktivitäten -- und liefern damit den Nachweis, den Sie benötigen, um Probleme zu beheben, Compliance-Anforderungen zu erfüllen und zu verstehen, was wann passiert ist.

VergeOS ordnet Logs in drei unterschiedliche Kategorien ein, die jeweils einem anderen Zweck dienen und an einem anderen Ort gespeichert werden. Das Verständnis dieser Kategorien ist entscheidend, um zu wissen, wo man bei der Diagnose eines Problems nachsehen muss und wie eine langfristige Aufbewahrung sichergestellt wird.

Log-Typen im Detail

System-Logs

System-Logs sind die primäre Log-Kategorie in VergeOS. Sie erfassen Aktivitäten im Zusammenhang mit vSAN-Operationen, VM-Lebenszyklusereignissen, Netzwerkänderungen, Benutzeranmeldungen, Konfigurationsänderungen, und anderen systembezogenen Vorgängen. Diese Logs sind unerlässlich, um den detaillierten Betrieb und die Leistung der gesamten Umgebung zu verstehen.

Beispiele für System-Logeinträge sind:

Ereignistyp
Beispiel-Logeintrag

Benutzerauthentifizierung

IP-Adresse, Benutzername, Anmeldezeitpunkt

Passwortänderungen

Welcher Benutzer welches Passwort von welcher Umgebung aus geändert hat

VM-Operationen

VM gestartet, gestoppt, migriert, Snapshot erstellt

Speicherereignisse

Laufwerkswarnungen, Statusänderungen der vSAN-Ebene, SMART-Warnungen

Netzwerkereignisse

Netzwerk erstellt, Firewall-Regel geändert, NIC-Statusänderung

Systemoperationen

Update heruntergeladen, Knoten neu gestartet, Wartungsmodus aktiviert

System-Logs sind über das Haupt-Dashboard (am unteren Rand der Seite) zugänglich oder durch Auswahl von Logs im oberen Menü. Jeder Logeintrag enthält ein Level (Kritisch, Fehler, Warnung oder Meldung), einen Zeitstempel, eine Quelle (z. B. node1, vSAN, Admin) und eine Meldung mit der Beschreibung des Ereignisses.

Synchronisierungs-Logs

Synchronisierungs-Logs beziehen sich speziell auf Standort-Synchronisierung (Replikation) Operationen. Sie sind sowohl auf den Dashboards für eingehende als auch ausgehende Synchronisierung verfügbar und bieten detaillierte Statistiken für jeden Snapshot-Synchronisierungsauftrag:

  • Start- und Stoppzeiten für jede Synchronisierungsoperation

  • Menge der geprüften Daten -- insgesamt auf Änderungen geprüfte Daten

  • Menge der gescannten Daten -- während der Synchronisierung gelesene Daten

  • Menge der gesendeten Daten -- als übertragungsbedürftig identifizierte geänderte Daten (vor der Komprimierung)

  • Netto gesendete Daten -- tatsächliche Bytes auf der Leitung (nach der Komprimierung)

  • Verzeichnis- und Dateianzahl -- Umfang der Synchronisierungsoperation

Synchronisierungs-Logs sind unschätzbar für die Überwachung des Replikationszustands, die Verifizierung, dass Disaster-Recovery-Aufträge planmäßig abgeschlossen werden, und die Diagnose von Bandbreiten- oder Leistungsproblemen bei der Standort-zu-Standort-Synchronisierung.

Systemereignisprotokoll (SEL)

Das Systemereignisprotokoll (SEL) enthält Ereignisse aus der Hardware-IPMI-Schnittstelle (Intelligent Platform Management Interface). Im Gegensatz zu System-Logs wird das SEL direkt auf der BMC-Hardware des Servers gespeichert, was bedeutet, dass es eine begrenzte und feste Kapazität hat. Sobald das SEL voll ist, können keine neuen Ereignisse mehr aufgezeichnet werden, bis es geleert wird.

Das Node-Dashboard zeigt eine Prozentleiste an, die angibt, wie viel SEL-Kapazität derzeit auf jedem Knoten genutzt wird. Zu den häufigen SEL-Einträgen gehören:

  • Überschreitungen von Temperaturschwellen

  • Warnungen zur Lüftergeschwindigkeit

  • Ereignisse der Stromversorgung

  • ECC-Fehler im Speicher

  • Thermische Ereignisse des Prozessors

  • Hardware-Initialisierungsereignisse

Log-Aufbewahrung im UI

VergeOS bewahrt System-Logs in der Benutzeroberfläche maximal 45 Tagelang auf. Nach diesem Zeitraum werden Logs automatisch aus dem UI gelöscht. Dieses Aufbewahrungsfenster reicht für die tägliche Fehlersuche und kurzfristige Audits aus, aber Organisationen mit Compliance-Anforderungen (HIPAA, SOC 2, PCI-DSS usw.) müssen die Weiterleitung externer Logs konfigurieren, um Logs länger aufzubewahren.

Kontextspezifische Logs

Eines der praktischsten Merkmale des VergeOS-Loggings ist die kontextspezifische Log-Filterung. In vielen Bereichen der Plattform -- etwa auf dem Dashboard einer einzelnen VM, eines Netzwerks oder eines Mandanten -- gibt es eine Logs Schaltfläche, die nur die für dieses spezifische Objekt relevanten Logs anzeigt.

Diese Eingrenzung macht es überflüssig, manuell durch Tausende systemweiter Logeinträge zu suchen. Zum Beispiel:

  • VM-Dashboard → Logs zeigt nur Ereignisse an, die diese spezifische VM betreffen (Start, Stopp, Migration, Snapshot, Fehler)

  • Netzwerk-Dashboard → Logs zeigt nur netzwerkbezogene Ereignisse an (Regeländerungen, Statusänderungen, Konnektivitätsereignisse)

  • Mandanten-Dashboard → Logs zeigt nur Ereignisse innerhalb des Geltungsbereichs dieses Mandanten an

Kontextspezifische Logs beschleunigen die Fehlersuche erheblich, indem das Signal-Rausch-Verhältnis genau auf das untersuchte Objekt eingegrenzt wird.

Externe Syslog-Weiterleitung

Für Organisationen, die eine Log-Aufbewahrung über 45 Tage hinaus benötigen oder VergeOS-Logs in eine zentrale Log-Management-Plattform (Graylog, Splunk, Elastic Stack, Datadog usw.) integrieren müssen, unterstützt VergeOS die externe Syslog-Weiterleitung über standardmäßige Syslog-Protokolle.

Konfigurationsschritte

Die externe Syslog-Weiterleitung wird über Erweiterte Einstellungen in der VergeOS-UI konfiguriert:

Schritt 1: Den externen Syslog-Server konfigurieren

  1. Navigieren Sie zu System → Einstellungen → Erweiterte Einstellungen

  2. In der Spalte , geben Sie syslog ein und drücken Sie Eingabe zum Suchen

  3. Auswählen und bearbeiten Externer Syslog-Server (tcp: @@name/ip:port, udp: @name/ip:port)

  4. Geben Sie das Syslog-Ziel unter Verwendung der passenden Syntax ein:

Protokoll
Syntax
Beispiel
Hinweise

TCP

@@<ip>:<port>

@@10.10.10.10:514

Zuverlässige Zustellung, empfohlen

UDP

@<ip>:<port>

@10.10.10.10:514

Geringerer Overhead, keine Zustellungsgarantie

  1. Klicken Sie auf Senden zum Speichern

Schritt 2: Die Formatvorlage konfigurieren

  1. Suchen Sie erneut nach syslog in den Erweiterten Einstellungen

  2. Auswählen und bearbeiten Vorlage, die für den Syslog-Server definiert werden soll (siehe rsyslog für das Format)

  3. Geben Sie ein Syslog-Vorlagenformat ein, das mit Ihrem Remote-Server kompatibel ist

Für Graylog unter Verwendung des RFC-5424-Formats:

  1. Klicken Sie auf Senden zum Speichern

Schritt 3: Die Weiterleitung überprüfen

Nach Abschluss der Konfiguration werden Logs an den angegebenen Syslog-Server weitergeleitet. Überprüfen Sie die eingehenden Logs Ihres Remote-Servers, um zu bestätigen, dass VergeOS-Einträge erfolgreich empfangen werden. Häufige Überprüfungsschritte:

  • Stellen Sie die Netzwerkkonnektivität zwischen VergeOS und dem Syslog-Server sicher (Port 514 oder benutzerdefinierter Port)

  • Vergewissern Sie sich, dass die Firewall-Regeln Syslog-Verkehr in beide Richtungen zulassen

  • Prüfen Sie das Log-Ingest-Dashboard des Remote-Servers auf eingehende Einträge

  • Erzeugen Sie ein Testereignis (z. B. An- und Abmeldung an der VergeOS-UI) und bestätigen Sie, dass es auf dem Remote-Server angezeigt wird

Voraussetzungen für die Syslog-Weiterleitung

Stellen Sie vor der Konfiguration der externen Log-Weiterleitung sicher, dass Folgendes erfüllt ist:

  • Netzwerkkonnektivität zwischen dem VergeOS-System und dem externen Syslog-Server

  • Firewall-Regeln die Syslog-Verkehr zulassen (typischerweise TCP- oder UDP-Port 514 oder Ihr benutzerdefinierter Port)

  • Zugriff auf die VergeOS-Systemeinstellungen mit Administratorrechten

  • Der externe Syslog-Server ist so konfiguriert, dass er eingehende Verbindungen akzeptiert aus dem VergeOS-IP-Bereich

SEL-Verwaltung

Da das SEL eine begrenzte Hardwarekapazität hat, erfordert es regelmäßige Wartung, um sicherzustellen, dass neue Ereignisse stets aufgezeichnet werden können.

SEL-Kapazität überwachen

Das Node-Dashboard zeigt eine Prozentleiste an, die die aktuelle SEL-Auslastung für jeden Knoten anzeigt. Überwachen Sie diesen Indikator regelmäßig -- insbesondere bei älterer Hardware, die möglicherweise mehr IPMI-Ereignisse erzeugt.

Das SEL leeren

Wenn sich das SEL seiner vollen Kapazität nähert, leeren Sie es mit dem folgenden Verfahren:

  1. Navigieren Sie zu Infrastruktur → Knoten

  2. Doppelklicken Sie auf den gewünschten Knoten, um auf das Node-Dashboard

  3. Klicken Sie auf SEL leeren im linken Menü zuzugreifen

  4. Klicken Sie auf Ja zur Bestätigung

Falsch-positive SEL-Einträge filtern

Einige Server-Hardware erzeugt wiederkehrende oder unkritische IPMI-Ereignisse, die das SEL und die System-Logs überladen. Häufige Fehlalarme sind:

  • Sensorwerte, die während der Startsequenz kurzzeitig Schwellenwerte überschreiten

  • Ereignisse der Stromversorgung während geplanter Wartungsfenster

  • Temperaturspitzen bei kurzen Lastspitzen, die sich sofort wieder normalisieren

Für dauerhafte falsch-positive Einträge unterstützt VergeOS das Filtern über einen hex-kodierten Syslog-Regex-Filter, der über die API konfiguriert wird. Starten Sie nach dem Anwenden des Filters den openipmi Dienst neu, um die Änderung zu aktivieren. Arbeiten Sie mit dem VergeOS-Support zusammen, um Anleitungen zur Implementierung von SEL-Filtern zu erhalten, die speziell für Ihre Hardwareplattform gelten.

SMTP-Aktivitätsberichte

Zusätzlich zu System-Logs und Syslog-Weiterleitung bietet VergeOS SMTP-Zustellungsberichte über das SMTP-Dashboard (behandelt auf der Abonnements & Warnungen Seite). Diese Berichte bieten Einblick in die E-Mail-Zustellungsaktivität:

  • Mail-Warteschlange -- Anzeigen ausstehender Nachrichten, Wiederholungsstatus und Zustellungsfehler

  • Mail-Log -- Audit-Trail aller gesendeten Abonnement-E-Mails mit Zeitstempeln und Zustellungsstatus

  • Tägliche Zustellungszusammenfassungen -- Verfolgen Sie die SMTP-Aktivität von gestern und heute, um zu bestätigen, dass Warnungen zugestellt werden

SMTP-Aktivitätsberichte ergänzen das Log-Management, indem sie einen sekundären Verifizierungskanal bereitstellen -- wenn Sie erwarten, eine Warnung zu erhalten, dies aber nicht geschieht, kann das SMTP-Log aufzeigen, ob die Nachricht in die Warteschlange gestellt, zugestellt oder abgelehnt wurde.

Best Practices für das Log-Management

Logs extern weiterleiten

Konfigurieren Sie die externe Syslog-Weiterleitung von Anfang an. Die 45-tägige Aufbewahrung im UI reicht für die meisten Compliance-Rahmenwerke nicht aus und schränkt die langfristige Trendanalyse ein.

SEL-Kapazität überwachen

Prüfen Sie regelmäßig die SEL-Prozentleiste auf jedem Node-Dashboard. Leeren Sie das SEL, bevor es die Kapazität erreicht, um den Verlust neuer Hardwareereignisse zu verhindern.

Kontextspezifische Logs verwenden

Wenn Sie eine bestimmte VM, ein Netzwerk oder einen Mandanten analysieren, verwenden Sie die kontextspezifische Schaltfläche Logs auf dem Dashboard dieses Objekts, um irrelevante Störmeldungen auszublenden.

Aufbewahrungsrichtlinien festlegen

Definieren Sie frühzeitig die organisatorischen Anforderungen an die Aufbewahrung. Nutzen Sie die Syslog-Weiterleitung zu einer zentralen Plattform für langfristige Speicherung, Suche und Compliance-Prüfungen.

VMware-Brücke

Kommt von VMware? In VergeOS leben operative und Audit-Ereignisse zusammen in einer einzigen filterbaren System-Logs-Ansicht (Kritisch/Fehler/Warnung/Meldung), die 45 Tage lang im UI aufbewahrt wird. Die externe Syslog-Weiterleitung wird einmal systemweit über zwei Felder in den Erweiterten Einstellungen konfiguriert -- Syslog-Server und Vorlage -- statt pro Host.

Nutanix-Brücke

Kommt von Nutanix? In VergeOS leben Systemoperationen und Audit-Ereignisse in einer System-Logs-Ansicht (45-tägige Aufbewahrung im UI); die externe Syslog-Weiterleitung wird einmal systemweit konfiguriert. Hardwareereignisse bleiben im SEL mit derselben Empfehlung zur proaktiven Leerung.

Wichtige Erkenntnisse

Drei Log-Typen

System-Logs für Betriebsereignisse, Synchronisierungs-Logs für Replikationsaktivitäten, und SEL für Hardware-IPMI-Ereignisse. Jeder dient einem anderen Zweck bei der Fehlersuche.

45-tägige UI-Aufbewahrung

VergeOS bewahrt System-Logs 45 Tage lang im UI auf. Konfigurieren Sie die externe Syslog-Weiterleitung für längere Aufbewahrung und Compliance-Anforderungen.

Einfache Syslog-Einrichtung

Zwei Felder der Erweiterten Einstellungen -- Syslog-Serveradresse und Vorlagenformat -- konfigurieren die Log-Weiterleitung für die gesamte Umgebung. TCP (@@) für Zuverlässigkeit, UDP (@) für Leistung.

SEL erfordert Wartung

Das Hardware-SEL hat eine feste Kapazität. Überwachen Sie die Prozentleiste auf jedem Node-Dashboard und leeren Sie das SEL proaktiv, um Ereignisverlust zu verhindern.

Zuletzt aktualisiert

War das hilfreich?