> 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-monitoring-und-fehlerbehebung/02-alerts.md).

# Abonnements & Warnungen

## Proaktive Überwachung mit Abonnements

Dashboards und Protokolle sind reaktiv -- Probleme sehen Sie erst, wenn Sie hinschauen. **Abonnements** Machen Sie das VergeOS-Monitoring proaktiv, indem E-Mail-Benachrichtigungen gesendet werden, wenn sich Bedingungen ändern oder in regelmäßigen Abständen. Jede VergeOS-Umgebung sollte von Anfang an einen Kernbestand an konfigurierten Abonnements haben, damit Administratoren vor den Endbenutzern von Problemen erfahren.

Abonnements erfordern eine funktionierende **SMTP-Konfiguration** (wird später auf dieser Seite behandelt). Sobald SMTP eingerichtet ist, kann jedes Dashboard, jeder Tier, jedes Netzwerk, jede VM, jeder Mandant oder jedes andere VergeOS-Objekt mit einem oder mehreren Abonnements verknüpft werden.

```mermaid
graph LR
    subgraph triggers["Abonnement-Engine"]
        direction TB
        OD["Bei Bedarf<br/>(Ereignis / Schwellenwert)"]
        SC["Geplant<br/>(zeitgesteuerte Berichte)"]
    end

    subgraph delivery["Zustellung"]
        SMTP["SMTP-Server"]
        QUEUE["Mail-Warteschlange"]
        INBOX["Admin-Posteingang"]
    end

    OD -->|Schwelle überschritten| SMTP
    SC -->|Intervall abgelaufen| SMTP
    SMTP --> QUEUE --> INBOX

    style triggers fill:#f0f4ff,stroke:#336
    style delivery fill:#f0fff4,stroke:#363
```

## Abonnementtypen

VergeOS bietet zwei sich ergänzende Abonnementtypen. Eine effektiv überwachte Umgebung verwendet **sowohl** die beiden Typen zusammen -- On-Demand-Abonnements für sofortige Kenntnis von Problemen und geplante Abonnements für Trendverfolgung und tägliche Überwachung.

### On-Demand-Abonnements

On-Demand-Abonnements sind **ereignisgesteuerte oder durch Schwellenwerte ausgelöste** Warnmeldungen. Sie werden ausgelöst, sobald eine Bedingung erfüllt ist, sodass Administratoren nahezu in Echtzeit über mögliche Probleme informiert werden.

Häufige Auslöser für On-Demand-Abonnements sind:

| Auslöserkategorie         | Beispiel                                                                          |
| ------------------------- | --------------------------------------------------------------------------------- |
| **Speicherschwellenwert** | vSAN-Tier erreicht einen festgelegten Prozentsatz der genutzten Kapazität         |
| **Update verfügbar**      | Neue VergeOS-Updatepakete sind zur Installation bereit                            |
| **Fehler / Warnungen**    | Jeder Fehler- oder Warnereignis wird auf einem überwachten Objekt protokolliert   |
| **Statusänderungen**      | Ein Knoten geht offline, eine VM stoppt unerwartet, ein Netzwerk hat einen Fehler |

On-Demand-Abonnements sind die erste Verteidigungslinie -- sie sagen Ihnen, dass etwas sofort Aufmerksamkeit braucht **jetzt**.

### Geplante Abonnements

Geplante Abonnements liefern **Dashboard- oder Listeninformationen in konfigurierten Zeitintervallen**. Sie sind darauf ausgelegt, regelmäßige Zusammenfassungen des Systemzustands bereitzustellen und Administratoren bei der täglichen Überwachung und Trendverfolgung zu unterstützen.

Beispiele für geplante Abonnements:

* **System-Dashboard** wird täglich um 7:00 Uhr gesendet -- gibt dem Team einen morgendlichen Gesundheitsüberblick
* **vSAN-Tier-Dashboard** wird wöchentlich gesendet -- verfolgt Kapazitätswachstumstrends im Laufe der Zeit
* **VM-Liste** wird wöchentlich gesendet -- überprüft das Inventar laufender Workloads
* **Mandanten-Dashboard** wird täglich gesendet -- überwacht den Ressourcenverbrauch des Mandanten

{% hint style="success" %}
**Effizientes Monitoring**

Eine gut überwachte VergeOS-Umgebung verfügt über **mehrere On-Demand- und geplante Abonnements** konfiguriert. On-Demand-Abonnements erfassen akute Ereignisse; geplante Abonnements machen langsam entstehende Trends wie den schrittweisen Kapazitätsverbrauch sichtbar.
{% endhint %}

## Ein Abonnement erstellen

Abonnements werden verwaltet unter **System > Abonnements** in der VergeOS-Benutzeroberfläche. Der Erstellungsablauf führt Sie durch die folgenden Felder:

### Schritt-für-Schritt-Konfiguration

1. Navigieren Sie zu **System > Abonnements** vom Cloud-Dashboard
2. Wählen Sie **Neu** im linken Menü
3. Konfigurieren Sie die Abonnementfelder:

| Feld                 | Beschreibung                                                                                                                                                          |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Namen**            | Ein eindeutiges Label für das Abonnement (wird in der Listenansicht und in den E-Mail-Betreffzeilen verwendet)                                                        |
| **Besitzertyp**      | **Benutzer** (einzelner Empfänger) oder **Gruppe** (Empfängerteam)                                                                                                    |
| **Besitzer**         | Wählen Sie den spezifischen Benutzer oder die Gruppe aus dem Dropdown-Menü aus                                                                                        |
| **Zieltyp**          | Die Kategorie des zu überwachenden VergeOS-Objekts (z. B. Cluster, vSAN-Tier, Netzwerk, VM, Mandant, System)                                                          |
| **Ziel**             | Die spezifische Instanz dieses Objekttyps (z. B. "Tier 1 - SSD", "Produktionsnetzwerk", "Knoten 1")                                                                   |
| **Typ**              | **Bei Bedarf** (ausgelöst) oder **Geplant** (zeitgesteuert)                                                                                                           |
| **Abonnementprofil** | Erforderlich -- definiert den Inhalt des Berichts/der Warnmeldung und, bei On-Demand, die Vergleichslogik; die angezeigten Optionen werden gefiltert nach **Zieltyp** |
| **Aussetzen**        | Benachrichtigungen optional bis zu einem Datum/Uhrzeitpunkt oder unbegrenzt pausieren (nützlich während Wartungsfenstern)                                             |

### On-Demand-Einstellungen

Wenn der Abonnementtyp auf **Bei Bedarf**gesetzt ist, werden zusätzliche Felder angezeigt:

| Feld                     | Beschreibung                                                                                                                                                                                                                        |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Abonnementprofil**     | Erforderliche Vorlage, die sowohl festlegt, was überwacht werden soll (`onchange_fields`) als auch wie es verglichen wird (`new`, `gt0`, `gt`, `anyval`, oder `different`) -- die verfügbaren Profile werden nach Zieltyp gefiltert |
| **Drosselung**           | Mindestanzahl von Minuten zwischen wiederholten Warnungen für dieselbe Bedingung -- verhindert, dass der Posteingang überflutet wird (max. 60 Minuten)                                                                              |
| **Erinnerungsintervall** | Wie oft die Warnung erneut gesendet wird, solange die Bedingung anhält (z. B. alle 4 Stunden)                                                                                                                                       |

Das **Drosselung** Die Einstellung ist für laute Umgebungen entscheidend. Ohne sie könnte eine flackernde Bedingung (z. B. ein Temperatursensor, der um einen Schwellenwert schwankt) Hunderte von E-Mails erzeugen. Die Drosselung ist begrenzt auf **60 Minuten** (das Feldmaximum); wählen Sie für die meisten Warnungen einen Wert zwischen 15 und 60 Minuten und verwenden Sie 60, wenn Sie die größtmögliche vom System zulässige Pause möchten.

Das **Erinnerungsintervall** stellt sicher, dass ein persistierendes Problem nicht vergessen wird. Wenn ein vSAN-Tier bei 90 % Kapazität liegt und niemand auf die erste Warnung reagiert, benachrichtigt die Erinnerung in dem konfigurierten Intervall erneut, bis die Bedingung behoben ist.

### Geplante Einstellungen

Wenn der Abonnementtyp auf **Geplant**, konfigurieren Sie den Zustellzeitpunkt:

| Feld           | Beschreibung                                                   |
| -------------- | -------------------------------------------------------------- |
| **Häufigkeit** | Wie oft der Bericht gesendet wird (z. B. täglich, wöchentlich) |
| **Uhrzeit**    | Die Uhrzeit, zu der der Bericht erstellt und zugestellt wird   |
| **Tag**        | Für wöchentliche Zeitpläne, welcher Wochentag                  |

## Abonnementprofile und Zielausrichtung

VergeOS-Abonnements sind bei der Zielauswahl flexibel — Sie können Abonnements für praktisch jedes Objekt im System erstellen:

### Auf Systemebene

Überwachen Sie das gesamte System-Dashboard, den Clusterzustand oder die Verfügbarkeit von Updates in der gesamten Umgebung.

### Auf Speicherebene

Verfolgen Sie einzelne vSAN-Tiers hinsichtlich Kapazitätsschwellen, Laufwerksfehlern oder verschlechtertem Redundanzstatus.

### Auf Netzwerkebene

Alarmieren Sie bei Netzwerkfehlern, Konnektivitätsänderungen oder Verkehrsanomalien auf bestimmten internen oder externen Netzwerken.

### Auf Workload-Ebene

Überwachen Sie einzelne VMs oder Mandantenumgebungen auf Statusänderungen, Ressourcenerschöpfung oder Fehlerereignisse.

Diese granulare Zielausrichtung bedeutet, dass Sie eine Abonnementstrategie aufbauen können, die zu Ihrem Betriebsmodell passt -- breite Alarme auf Systemebene für das Infrastrukturteam und spezifische VM- oder Mandantenalarme für Anwendungsbesitzer oder MSP-Kunden.

## Häufige Alarmkonfigurationen

Die folgenden Abonnementkonfigurationen stellen Best Practices für die meisten VergeOS-Bereitstellungen dar. Betrachten Sie sie als eine **Ausgangsvorlage** und passen Sie sie an Ihre Umgebung an.

### Warnungen zur Speicherkapazität

| Einstellung          | Wert                                                                                                     |
| -------------------- | -------------------------------------------------------------------------------------------------------- |
| **Zieltyp**          | vSAN-Tier                                                                                                |
| **Ziel**             | Jedes Tier einzeln (Tier 1, Tier 2 usw.)                                                                 |
| **Typ**              | Bei Bedarf                                                                                               |
| **Abonnementprofil** | Ein vSAN-Tier-Kapazitätsprofil (z. B. "Verwendete %") das die Nutzung mit einem Schwellenwert vergleicht |
| **Drosselung**       | 60 Minuten                                                                                               |
| **Erinnerung**       | 4 Stunden                                                                                                |

Erstellen Sie separate Abonnements für mehrere Schwellenwerte (80 % Warnung, 90 % kritisch), um eine gestaffelte Dringlichkeit bereitzustellen.

### Erkennung eines offline gegangenen Knotens

| Einstellung          | Wert                                                                  |
| -------------------- | --------------------------------------------------------------------- |
| **Zieltyp**          | Knoten                                                                |
| **Ziel**             | Jeder Knoten einzeln                                                  |
| **Typ**              | Bei Bedarf                                                            |
| **Abonnementprofil** | Ein Knotenstatusprofil, das einen Übergang aus Running heraus erkennt |
| **Drosselung**       | 15 Minuten                                                            |
| **Erinnerung**       | 1 Stunde                                                              |

### vSAN degradierter Zustand

| Einstellung          | Wert                                                                       |
| -------------------- | -------------------------------------------------------------------------- |
| **Zieltyp**          | vSAN-Tier                                                                  |
| **Ziel**             | Jedes Tier einzeln                                                         |
| **Typ**              | Bei Bedarf                                                                 |
| **Abonnementprofil** | Ein vSAN-Tier-Zustandsprofil, das bei Fehler- oder Warnereignissen auslöst |
| **Drosselung**       | 30 Minuten                                                                 |
| **Erinnerung**       | 2 Stunden                                                                  |

### Verfügbare Updates

| Einstellung          | Wert                                                                       |
| -------------------- | -------------------------------------------------------------------------- |
| **Zieltyp**          | System                                                                     |
| **Typ**              | Bei Bedarf                                                                 |
| **Abonnementprofil** | Ein Profil zur Updateverfügbarkeit, das neue installierbare Pakete erkennt |
| **Drosselung**       | 60 Minuten (das Maximum)                                                   |
| **Erinnerung**       | 7 Tage                                                                     |

### Täglicher Bericht zum Systemzustand

| Einstellung    | Wert             |
| -------------- | ---------------- |
| **Zieltyp**    | System-Dashboard |
| **Typ**        | Geplant          |
| **Häufigkeit** | Täglich          |
| **Uhrzeit**    | 7:00 Uhr         |

## Voraussetzung für die SMTP-Konfiguration

Abonnements verlassen sich vollständig auf die E-Mail-Zustellung. Bevor ein Abonnement Benachrichtigungen senden kann, **muss SMTP konfiguriert sein** bei **System > SMTP** in der VergeOS-Oberfläche.

VergeOS stellt einen integrierten Mailserver bereit, der E-Mails entweder **direkt** senden oder über einen **SMTP-Relay** Dienst weiterleiten kann.

### SMTP-Einstellungen

Navigieren Sie zu **System > SMTP > Einstellungen bearbeiten** und konfigurieren Sie Folgendes:

| Einstellung                      | Beschreibung                                                                                                              |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **TLS verwenden**                | TLS-Verschlüsselung aktivieren/deaktivieren -- immer aktivieren, wenn sie vom Relay oder Empfangsserver unterstützt wird  |
| **Hostnamen**                    | FQDN des sendenden Servers -- muss sich in DNS mit korrektem SPF, DMARC und Reverse DNS auflösen                          |
| **Absendername**                 | Anzeigename, der in E-Mail-Nachrichten erscheint (z. B. "VergeOS-Warnungen")                                              |
| **Absenderadresse**              | Quell-E-Mail-Adresse für alle Abonnement-E-Mails                                                                          |
| **Relay-Host**                   | Adresse eines externen SMTP-Relay-Servers (leer lassen für direktes Senden)                                               |
| **Relay-Port**                   | TCP-Port für das Relay -- 25 (unverschlüsselt), 587 (TLS/STARTTLS) oder 465 (altes SSL)                                   |
| **SASL-Autorisierung verwenden** | Aktivieren, wenn das Relay eine Authentifizierung erfordert -- blendet unten die Felder für Benutzername und Passwort ein |
| **Benutzername**                 | SASL-Benutzername für die Relay-Authentifizierung (wird angezeigt, wenn SASL-Autorisierung aktiviert ist)                 |
| **Passwort**                     | SASL-Passwort für die Relay-Authentifizierung (wird angezeigt, wenn SASL-Autorisierung aktiviert ist)                     |

### Direktversand vs. Relay

| Ansatz            | Vorteile                                             | Nachteile                                                                      |
| ----------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------ |
| **Direktversand** | Keine externen Abhängigkeiten, sofortige Zustellung  | Erfordert korrektes DNS/SPF/DMARC/rDNS, kann von Spamfiltern abgefangen werden |
| **SMTP-Relay**    | Bessere Zustellbarkeit, einfachere DNS-Anforderungen | Hängt von einem externen Dienst ab, kann Ratenbegrenzungen haben               |

{% hint style="success" %}
**Praktische Empfehlung**

Viele Kunden entscheiden sich für einen kommerziellen SMTP-Relay-Dienst (z. B. SendGrid, Amazon SES oder ein internes Exchange-Relay), weil er die DNS-Konfiguration vereinfacht, die Zustellbarkeit verbessert und Probleme mit Spamfiltern vermeidet. Der Relay-Anbieter stellt die richtigen Host-, Port- und Zugangsdaten für Ihre SMTP-Konfiguration bereit.
{% endhint %}

### DNS- und Zustellbarkeitsanforderungen

Wenn Sie **direkt versenden** (ohne Relay), müssen die folgenden DNS-Einträge korrekt konfiguriert sein, damit E-Mails nicht abgewiesen oder als Spam markiert werden:

* **SPF-Eintrag** -- Autorisiert die IP des VergeOS-Servers, E-Mails für die konfigurierte Domäne zu senden
* **DMARC-Eintrag** -- Definiert die E-Mail-Authentifizierungsrichtlinie der Domäne
* **Reverse DNS (PTR)** -- Die sendende IP muss einen PTR-Eintrag haben, der zum konfigurierten Hostnamen passt
* **MX-Eintrag** -- Obwohl für das Senden nicht erforderlich, hilft eine korrekte MX-Konfiguration, die Legitimität der Domäne zu belegen

### SMTP-Dashboard und Überwachung

Das **SMTP-Dashboard** (System > SMTP) bietet operative Transparenz bei der E-Mail-Zustellung:

* **Mail-Warteschlange** -- Ausstehende Nachrichten, Wiederholungsstatus und Zustellfehler anzeigen
* **Mail-Protokoll** -- Audit-Protokoll aller gesendeten Nachrichten mit Zeitstempeln und Zustellstatus
* **Test-E-Mail** -- Senden Sie eine Testnachricht, um die Konfiguration zu überprüfen, bevor Sie sich für Produktionswarnungen darauf verlassen

Senden Sie immer eine **Test-E-Mail** nachdem Sie SMTP konfiguriert und bevor Sie Abonnements erstellen. Dies validiert die End-to-End-Zustellung einschließlich DNS-Auflösung, TLS-Aushandlung, Relay-Authentifizierung und Platzierung im Posteingang.

## Abonnementverwaltung

### Anzeigen und Bearbeiten von Abonnements

Alle konfigurierten Abonnements sind aufgeführt unter **System > Abonnements**. Von dieser Ansicht aus können Sie:

* Den Besitzer, das Ziel, den Typ und den Status jedes Abonnements sehen
* Bestehende Abonnements bearbeiten, um Schwellenwerte, Drosselungsintervalle oder Empfänger anzupassen
* Abonnements löschen, die nicht mehr benötigt werden
* Schnell erkennen, welche Objekte eine Alarmabdeckung haben und welche nicht

### Überlegungen zu Multi-Tenant-Umgebungen

In Multi-Tenant-Umgebungen können Abonnements **auf jeder Mandantenebene unabhängig konfiguriert werden**. Das bedeutet:

* Das **Dienstanbieter** konfiguriert systemweite Abonnements auf der Host-Umgebung
* Jeder **Mandantenadministrator** kann seine eigenen Abonnements innerhalb seines Mandantenbereichs konfigurieren
* Abonnements von Mandanten haben nur Sicht auf ihre eigenen Ressourcen -- sie können keine Objekte auf Host-Ebene sehen oder dafür Alarme auslösen

Diese Isolation stellt sicher, dass MSP-Kunden ihre Benachrichtigungen selbst verwalten können, ohne dass ein Eingreifen des Anbieters erforderlich ist.

{% hint style="info" %}
**Kommen Sie von VMware oder Nutanix?**

In VergeOS vereint ein einzelnes **Abonnement** die Bedingung (über sein Abonnementprofil), die Weiterleitung (Besitzer + SMTP) und alle geplanten Dashboard-Berichte in einem Objekt -- sodass Sie alle drei zusammen für dasselbe Ziel konfigurieren, anstatt separate Konstrukte zusammenzusetzen.
{% endhint %}

## Wichtige Erkenntnisse

### Zwei Abonnementtypen

**Bei Bedarf** für sofortige Ereignis-/Schwellenwertwarnungen und **Geplant** für wiederkehrende Dashboard-Berichte. Verwenden Sie beide zusammen für eine vollständige Abdeckung.

### SMTP zuerst

Konfigurieren und testen Sie die SMTP-Zustellung, bevor Sie irgendwelche Abonnements erstellen. Direktversand oder Relay -- beides funktioniert, aber ein Relay ist oft einfacher zu warten.

### Drosselung und Erinnern

Verwenden Sie Drosselungseinstellungen, um Warnungsstürme zu verhindern, und Erinnerungsintervalle, um sicherzustellen, dass persistierende Probleme nicht vergessen werden.

### Beliebige Ziele

Abonnements können jedes VergeOS-Objekt als Ziel verwenden -- Systeme, Cluster, Tiers, Netzwerke, VMs und Mandanten -- für maximale Überwachungsflexibilität.


---

# 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/learn-the-platform/de/modul-9-monitoring-und-fehlerbehebung/02-alerts.md?ask=<question>&goal=<endgoal>
```

`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.
