> 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/learn-the-platform/de/modul-9-uberwachung-and-fehlerbehebung/03-log-management.md).

# 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 Protokollen in VergeOS-Betriebsvorgängen

Protokolle sind der Prüfpfad und das diagnostische Rückgrat jeder VergeOS-Umgebung. Sie zeichnen benutzerinitiierte Aktionen, automatisierte Systemereignisse, Hardware-Sensorwerte und Replikationsaktivitäten auf -- und liefern so die Nachweise, die Sie benötigen, um Probleme zu beheben, Compliance-Anforderungen zu erfüllen und nachzuvollziehen, was wann passiert ist.

VergeOS organisiert Protokolle in drei verschiedene Kategorien, die jeweils einem anderen Zweck dienen und an unterschiedlichen Orten gespeichert werden. Das Verständnis dieser Kategorien ist entscheidend, um zu wissen, wo bei der Diagnose eines Problems nachzusehen ist und wie eine langfristige Aufbewahrung sichergestellt wird.

```mermaid
graph TB
    subgraph logTypes["VergeOS-Protokollkategorien"]
        direction TB
        SYS["Systemprotokolle<br/>Benutzer- und automatisierte Aktivitäten<br/>vSAN-, VM- und Netzwerkereignisse"]
        SYNC["Synchronisierungsprotokolle<br/>Replikationsaktivitäten der Standortsynchronisierung<br/>Start/Stopp, übertragene Daten"]
        SEL["Systemereignisprotokoll (SEL)<br/>Hardware-IPMI-Ereignisse<br/>Auf BMC-Hardware gespeichert"]
    end

    subgraph retention["Aufbewahrung"]
        UI["Im UI: 45 Tage"]
        HW["Auf der Hardware: Begrenzte Kapazität"]
        EXT["Extern: Syslog-Weiterleitung"]
    end

    SYS --> UI
    SYNC --> UI
    SEL --> HW
    SYS --> EXT
    SEL --> EXT

    style logTypes fill:#f0f4ff,stroke:#336
    style retention fill:#f0fff4,stroke:#363
```

## Protokolltypen im Detail

### Systemprotokolle

Systemprotokolle sind die primäre Protokollkategorie in VergeOS. Sie erfassen Aktivitäten im Zusammenhang mit **vSAN-Vorgängen, VM-Lebenszyklusereignissen, Netzwerkänderungen, Benutzeranmeldungen, Konfigurationsänderungen**und anderen systembezogenen Vorgängen. Diese Protokolle sind entscheidend, um den detaillierten Betrieb und die Leistung der gesamten Umgebung zu verstehen.

Beispiele für Systemprotokolleinträge sind:

| Ereignistyp                   | Beispiel-Protokolleintrag                                               |
| ----------------------------- | ----------------------------------------------------------------------- |
| **Benutzerauthentifizierung** | IP-Adresse, Benutzername, Anmeldezeitstempel                            |
| **Passwortänderungen**        | Welcher Benutzer welches Passwort von welcher Umgebung aus geändert hat |
| **VM-Vorgänge**               | 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          |
| **Systemvorgänge**            | Update heruntergeladen, Knoten neu gestartet, Wartungsmodus aktiviert   |

Systemprotokolle sind zugänglich über das **Haupt-Dashboard** (am unteren Rand der Seite) oder durch Auswahl von **Protokolle** im oberen Menü. Jeder Protokolleintrag enthält eine **Stufe** (Kritisch, Fehler, Warnung oder Nachricht), einen **Zeitstempel**, einen **source** (z. B. Knoten1, vSAN, Admin), und eine **Nachricht** die das Ereignis beschreibt.

### Synchronisierungsprotokolle

Synchronisierungsprotokolle sind spezifisch für **Standortsynchronisierung (Replikation)** Vorgänge. Sie sind sowohl auf den Dashboards für eingehende als auch für ausgehende Synchronisierung verfügbar und bieten detaillierte Statistiken für jeden Snapshot-Synchronisierungsauftrag:

* **Start- und Stoppzeiten** für jeden Synchronisierungsvorgang
* **Menge der überprüften Daten** -- insgesamt auf Änderungen geprüfte Daten
* **Menge der gescannten Daten** -- während der Synchronisierung gelesene Daten
* **Menge der gesendeten Daten** -- geänderte Daten, die als übertragungsbedürftig identifiziert wurden (vor der Komprimierung)
* **Netto gesendete Daten** -- tatsächliche Bytes auf der Leitung (nach der Komprimierung)
* **Verzeichnis- und Dateizählungen** -- Umfang des Synchronisierungsvorgangs

Synchronisierungsprotokolle sind von unschätzbarem Wert, um den Zustand der Replikation zu überwachen, zu überprüfen, ob Disaster-Recovery-Aufträge planmäßig abgeschlossen werden, und Bandbreiten- oder Leistungsprobleme bei der Site-to-Site-Synchronisierung zu diagnostizieren.

### Systemereignisprotokoll (SEL)

Das System Event Log (SEL) enthält Ereignisse aus der **Hardware-IPMI-Schnittstelle** (Intelligent Platform Management Interface). Im Gegensatz zu Systemprotokollen 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 neue Ereignisse nicht mehr aufgezeichnet werden, bis es geleert wird.

Das Knoten-Dashboard zeigt eine **Prozentanzeige** an, die zeigt, wie viel der SEL-Kapazität auf jedem Knoten derzeit genutzt wird. Häufige SEL-Einträge sind:

* Überschreitungen von Temperaturgrenzwerten
* Warnungen zur Lüfterdrehzahl
* Netzteilereignisse
* ECC-Speicherfehler
* Thermische Ereignisse des Prozessors
* Hardware-Initialisierungsereignisse

{% hint style="warning" %}
**Die SEL-Kapazität ist begrenzt**

Das SEL wird auf dem Baseboard Management Controller (BMC) des Servers gespeichert und hat eine begrenzte, feste Kapazität. Wenn das SEL vollständig voll ist, werden neue Hardwareereignisse stillschweigend verworfen. Überwachen Sie auf jedem Knoten-Dashboard den Prozentsatz der SEL-Kapazität und leeren Sie das SEL proaktiv.
{% endhint %}

## Protokollaufbewahrung im UI

VergeOS bewahrt Systemprotokolle in der Benutzeroberfläche maximal **45 Tage**auf. Nach diesem Zeitraum werden Protokolle automatisch aus der 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 Remote-Logweiterleitung** konfigurieren, um Protokolle länger aufzubewahren.

### Kontextspezifische Protokolle

Eine der praktischsten Funktionen der Protokollierung in VergeOS ist **kontextspezifische Protokollfilterung**. In vielen Bereichen der Plattform -- etwa auf dem Dashboard einer einzelnen VM, einem Netzwerk-Dashboard oder einem Mandanten-Dashboard -- gibt es eine **Protokolle** Schaltfläche, die nur die für dieses spezifische Objekt relevanten Protokolle anzeigt.

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

* **VM-Dashboard → Protokolle** zeigt nur Ereignisse im Zusammenhang mit dieser spezifischen VM (Start, Stopp, Migration, Snapshot, Fehler)
* **Netzwerk-Dashboard → Protokolle** zeigt nur netzwerkbezogene Ereignisse (Regeländerungen, Statusänderungen, Verbindungsereignisse)
* **Mandanten-Dashboard → Protokolle** zeigt nur Ereignisse innerhalb des Geltungsbereichs dieses Mandanten

Kontextspezifische Protokolle beschleunigen die Fehlersuche erheblich, indem sie das Signal-Rausch-Verhältnis genau auf das zu untersuchende Objekt eingrenzen.

## Remote-Syslog-Weiterleitung

Für Organisationen, die eine Protokollaufbewahrung über 45 Tage hinaus benötigen oder VergeOS-Protokolle in eine zentrale Plattform für Protokollverwaltung (Graylog, Splunk, Elastic Stack, Datadog usw.) integrieren müssen, unterstützt VergeOS **die Remote-Syslog-Weiterleitung** über standardisierte Syslog-Protokolle.

### Konfigurationsschritte

Die Remote-Syslog-Weiterleitung wird über **Erweiterte Einstellungen** in der VergeOS-Benutzeroberfläche konfiguriert:

#### Schritt 1: Den Remote-Syslog-Server konfigurieren

1. Navigieren Sie zu **System → Einstellungen → Erweiterte Einstellungen**
2. In der **Einstellung** Spalte, geben Sie `syslog` ein und drücken Sie **Enter** zum Suchen
3. Auswählen und bearbeiten **Remote-Syslog-Server (tcp: @@name/ip:port, udp: @name/ip:port)**
4. Geben Sie das Syslog-Ziel mit der entsprechenden 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 Zustellgarantie |

5. Klicken Sie auf **Senden** zum Speichern

#### Schritt 2: Die Vorlagenformatierung konfigurieren

1. Suchen Sie erneut nach `syslog` in den erweiterten Einstellungen
2. Auswählen und bearbeiten **Vorlage zur Definition für den Syslog-Server (siehe rsyslog für das Format)**
3. Geben Sie ein mit Ihrem entfernten Server kompatibles Syslog-Vorlagenformat ein

Für **Graylog** im RFC-5424-Format:

```
GRAYLOGRFC5424,"<%PRI%>1 %TIMESTAMP:::date-rfc3339% %HOSTNAME%.your-hostname-here %APP-NAME% %PROCID% %MSGID% %STRUCTURED-DATA% %msg%\n"
```

{% hint style="warning" %}
Verwenden Sie den Literalwert `1` nach `<%PRI%>` — das ist das Versionsfeld von RFC 5424. Verwenden Sie nicht `%PROTOCOL-VERSION%`: es wird dargestellt als `0` auf der Leitung, und strenge RFC-5424-Collector (Promtail/Loki, Fluent Bit, modernes Graylog) lehnen Version 0 mit Parsefehlern ab.
{% endhint %}

{% hint style="success" %}
**Vorlagenanpassung**

Ersetzen Sie `your-hostname-here` durch Ihren tatsächlichen Hostnamen, damit die Protokolleinträge in Ihrer zentralisierten Protokollplattform leicht identifizierbar sind. Die Vorlage folgt der rsyslog-Syntax -- konsultieren Sie die [rsyslog-Dokumentation](https://www.rsyslog.com/doc/configuration/examples.html) für zusätzliche Formatoptionen.
{% endhint %}

4. Klicken Sie auf **Senden** zum Speichern

#### Schritt 3: Weiterleitung überprüfen

Nach Abschluss der Konfiguration werden Protokolle an den angegebenen Syslog-Server weitergeleitet. Überprüfen Sie die eingehenden Protokolle auf Ihrem entfernten Server, um sicherzustellen, dass VergeOS-Einträge erfolgreich empfangen werden. Häufige Überprüfungsschritte:

* Bestätigen Sie die Netzwerkkonnektivität zwischen VergeOS und dem Syslog-Server (Port 514 oder benutzerdefinierter Port)
* Überprüfen Sie, dass die Firewall-Regeln Syslog-Verkehr in beide Richtungen zulassen
* Prüfen Sie das Protokoll-Ingestion-Dashboard des entfernten Servers auf eingehende Einträge
* Erzeugen Sie ein Testereignis (z. B. An- und Abmelden in der VergeOS-Benutzeroberfläche) und bestätigen Sie, dass es auf dem entfernten Server erscheint

### Voraussetzungen für die Syslog-Weiterleitung

Bevor Sie die Remote-Protokollweiterleitung konfigurieren, stellen Sie sicher, dass Folgendes erfüllt ist:

* **Netzwerkkonnektivität** zwischen dem VergeOS-System und dem entfernten Syslog-Server
* **Firewall-Regeln** die Syslog-Verkehr zulassen (typischerweise TCP- oder UDP-Port 514 oder Ihren benutzerdefinierten Port)
* **Zugriff auf die VergeOS-Systemeinstellungen** mit administrativen Rechten
* Der entfernte 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, damit neue Ereignisse stets aufgezeichnet werden können.

### SEL-Kapazität überwachen

Die **Knoten-Dashboard** zeigt einen Prozentsatzbalken, der die aktuelle SEL-Nutzung für jeden Knoten anzeigt. Überwachen Sie diesen Indikator regelmäßig -- insbesondere bei älterer Hardware, die mehr IPMI-Ereignisse erzeugen kann.

### SEL leeren

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

1. Navigieren Sie zu **Infrastruktur → Knoten**
2. Doppelklicken Sie auf den gewünschten Knoten, um auf das **Knoten-Dashboard**
3. Klicken Sie auf **SEL leeren** im linken Menü
4. Klicken Sie auf **Ja** zum Bestätigen

{% hint style="success" %}
**Proaktive SEL-Verwaltung**

Erwägen Sie, einen regelmäßigen Zeitplan zum Leeren des SEL festzulegen -- zum Beispiel monatlich oder vierteljährlich --, um zu verhindern, dass es seine Kapazität erreicht. Exportieren Sie vor dem Leeren die SEL-Einträge auf Ihren entfernten Syslog-Server oder dokumentieren Sie alle bedeutenden Ereignisse für Ihre Unterlagen.
{% endhint %}

### Filterung falsch-positiver SEL-Einträge

Einige Serverhardware erzeugt wiederkehrende oder harmlose IPMI-Ereignisse, die das SEL und die Systemprotokolle überladen. Häufige Fehlalarme sind:

* Sensorwerte, die während Startsequenzen kurzzeitig Grenzwerte überschreiten
* Netzteilereignisse während geplanter Wartungsfenster
* Temperaturspitzen bei kurzen Lastspitzen, die sich sofort wieder normalisieren

Für anhaltende 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 Anwenden des Filters den `openipmi` Dienst neu, um die Änderung zu aktivieren. Arbeiten Sie mit dem VergeOS-Support zusammen, um Hinweise zur Implementierung von SEL-Filtern zu erhalten, die speziell auf Ihre Hardwareplattform zugeschnitten sind.

## SMTP-Aktivitätsberichte

Zusätzlich zu Systemprotokollen und Syslog-Weiterleitung bietet VergeOS **SMTP-Zustellberichte** über das SMTP-Dashboard (beschrieben auf der [Abonnements & Warnungen](https://docs.verge.io/learn-the-platform/de/modul-9-uberwachung-and-fehlerbehebung/02-alerts.md) Seite). Diese Berichte verschaffen Einblick in die E-Mail-Zustellaktivität:

* **Mail-Warteschlange** -- Anzeigen ausstehender Nachrichten, Wiederholungsstatus und Zustellfehler
* **Mail-Protokoll** -- Prüfpfad aller gesendeten Abonnement-E-Mails mit Zeitstempeln und Zustellstatus
* **Tägliche Zustellzusammenfassungen** -- Verfolgen Sie die SMTP-Aktivität von gestern und heute, um zu bestätigen, dass Warnungen zugestellt werden

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

## Best Practices für die Protokollverwaltung

### Protokolle extern weiterleiten

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

### SEL-Kapazität überwachen

Überprüfen Sie regelmäßig den SEL-Prozentsatzbalken auf jedem Knoten-Dashboard. Leeren Sie das SEL, bevor es seine Kapazität erreicht, um den Verlust neuer Hardwareereignisse zu verhindern.

### Kontextspezifische Protokolle verwenden

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

### Aufbewahrungsrichtlinien festlegen

Definieren Sie die organisatorischen Aufbewahrungsanforderungen frühzeitig. Verwenden Sie die Syslog-Weiterleitung zu einer zentralisierten Plattform für langfristige Speicherung, Suche und Compliance-Prüfung.

{% hint style="info" %}
**VMware-Brücke**

Kommt von VMware? In VergeOS befinden sich Betriebs- und Audit-Ereignisse gemeinsam in einer einzigen filterbaren Systemprotokolle-Ansicht (Kritisch/Fehler/Warnung/Nachricht), die 45 Tage lang in der UI aufbewahrt wird. Die Remote-Syslog-Weiterleitung wird einmal systemweit über zwei Felder in den erweiterten Einstellungen konfiguriert -- Syslog-Server und Vorlage -- statt pro Host.
{% endhint %}

{% hint style="info" %}
**Nutanix-Brücke**

Kommt von Nutanix? In VergeOS befinden sich Systemvorgänge und Audit-Ereignisse in einer Systemprotokolle-Ansicht (45-tägige Aufbewahrung in der UI); die Remote-Syslog-Weiterleitung wird einmal systemweit konfiguriert. Hardwareereignisse verbleiben im SEL, mit derselben proaktiven Empfehlung zum Leeren.
{% endhint %}

## Wichtige Erkenntnisse

### Drei Protokolltypen

**Systemprotokolle** für Betriebsereignisse, **Synchronisierungsprotokolle** für Replikationsaktivitäten und **SEL** für Hardware-IPMI-Ereignisse. Jeder dient einem eigenen Zweck bei der Fehlersuche.

### 45-tägige UI-Aufbewahrung

VergeOS bewahrt Systemprotokolle 45 Tage lang in der UI auf. Konfigurieren Sie die Remote-Syslog-Weiterleitung für längere Aufbewahrung und Compliance-Anforderungen.

### Einfache Syslog-Einrichtung

Zwei Felder in den erweiterten Einstellungen -- Syslog-Serveradresse und Vorlagenformat -- konfigurieren die Protokollweiterleitung 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 den Prozentsatzbalken auf jedem Knoten-Dashboard und leeren Sie das SEL proaktiv, um den Verlust von Ereignissen zu verhindern.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/learn-the-platform/de/modul-9-uberwachung-and-fehlerbehebung/03-log-management.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
