#022 Cluster-Abgleich #22

New Issue

2026-09-18T16:05:28Z

florian.wilde commented

2026-09-18 16:05:28 +00:00

Ziel

In einem Proxmox-Cluster hat jeder Knoten eine eigene Subscription mit eigener Server-ID. Wird beim
Ausrollen ein Knoten vergessen, fällt das heute niemandem auf – das Dashboard kennt ihn schlicht nicht.
Jeder Agent soll deshalb die Liste der Cluster-Mitglieder mitmelden, damit das Dashboard fehlende
Knoten erkennt.

Aufgaben

Agent meldet clusterMitglieder (Namen aller Knoten laut pvecm nodes)
Agent-API nimmt das Feld entgegen (optional, wie alle anderen)
Datenmodell: Feld am Host, Migration
Warnregel „Cluster-Knoten ohne Agent“
Host-Detail zeigt die Mitglieder mit Zustand (meldet sich / kein Agent)
Tests: Agent mit nachgebautem pvecm, Regel mit vollständigem und lückenhaftem Cluster

Akzeptanzkriterien

Ein Cluster mit drei Knoten und zwei Agents erzeugt genau eine Warnung
Sobald der dritte Agent meldet, schließt sich die Warnung von selbst
Hosts ohne Cluster erzeugen keine Warnung

Abhängigkeiten

#005, #011, #018

Notizen / Entscheidungen

Entstanden beim Feldtest (#018) an einem echten Cluster mit drei Knoten: Alle drei haben eigene
Server-IDs und eigenen Status, bestätigt über pvesh get /nodes/<name>/subscription.
Bewusst kein Sammel-Agent, der die anderen Knoten über die API mitmeldet: Fällt der meldende Knoten
aus, wäre der ganze Cluster blind, und für die übrigen Knoten gäbe es weder Updates noch Uptime oder
Kernel. Stattdessen Agent je Knoten plus dieser Abgleich.
Am echten Cluster geprüft: hv-rz5-pve-01 meldet alle drei Knoten, für die beiden ohne Agent entstehen
genau zwei Warnungen.
Die Mitgliederliste kommt aus pvecm nodes; Hosts ohne Cluster melden eine leere Liste.
Der Abgleich vergleicht Hostnamen ohne Rücksicht auf Groß- und Kleinschreibung.

Quelle: docs/issues/022-cluster-abgleich.md – dort wird dieses Issue gepflegt.

## Ziel In einem Proxmox-Cluster hat jeder Knoten eine eigene Subscription mit eigener Server-ID. Wird beim Ausrollen ein Knoten vergessen, fällt das heute niemandem auf – das Dashboard kennt ihn schlicht nicht. Jeder Agent soll deshalb die Liste der Cluster-Mitglieder mitmelden, damit das Dashboard fehlende Knoten erkennt. ## Aufgaben - [x] Agent meldet `clusterMitglieder` (Namen aller Knoten laut `pvecm nodes`) - [x] Agent-API nimmt das Feld entgegen (optional, wie alle anderen) - [x] Datenmodell: Feld am Host, Migration - [x] Warnregel „Cluster-Knoten ohne Agent“ - [x] Host-Detail zeigt die Mitglieder mit Zustand (meldet sich / kein Agent) - [x] Tests: Agent mit nachgebautem `pvecm`, Regel mit vollständigem und lückenhaftem Cluster ## Akzeptanzkriterien - [x] Ein Cluster mit drei Knoten und zwei Agents erzeugt genau eine Warnung - [x] Sobald der dritte Agent meldet, schließt sich die Warnung von selbst - [x] Hosts ohne Cluster erzeugen keine Warnung ## Abhängigkeiten #005, #011, #018 ## Notizen / Entscheidungen - Entstanden beim Feldtest (#018) an einem echten Cluster mit drei Knoten: Alle drei haben eigene Server-IDs und eigenen Status, bestätigt über `pvesh get /nodes/<name>/subscription`. - Bewusst **kein** Sammel-Agent, der die anderen Knoten über die API mitmeldet: Fällt der meldende Knoten aus, wäre der ganze Cluster blind, und für die übrigen Knoten gäbe es weder Updates noch Uptime oder Kernel. Stattdessen Agent je Knoten plus dieser Abgleich. - Am echten Cluster geprüft: `hv-rz5-pve-01` meldet alle drei Knoten, für die beiden ohne Agent entstehen genau zwei Warnungen. - Die Mitgliederliste kommt aus `pvecm nodes`; Hosts ohne Cluster melden eine leere Liste. - Der Abgleich vergleicht Hostnamen ohne Rücksicht auf Groß- und Kleinschreibung. --- Quelle: `docs/issues/022-cluster-abgleich.md` – dort wird dieses Issue gepflegt.

florian.wilde added this to the v0.14.0 milestone 2026-09-18 16:05:28 +00:00

florian.wilde added the backend agent alerts labels 2026-09-18 16:05:28 +00:00

florian.wilde closed this issue

2026-09-18 16:05:29 +00:00

florian.wilde referenced this issue

2026-09-18 16:45:42 +00:00

#018 Agent auf echten Proxmox-Hosts prüfen #18

florian.wilde referenced this issue

2026-09-18 16:45:44 +00:00

#023 Feldtest auf Proxmox Backup Server und Mail Gateway #23

Sign in to join this conversation.