fix(agent): Cluster-Knoten mit QDevice richtig lesen (#042)

Der Agent nahm aus `pvecm nodes` blind die dritte Spalte als Knotennamen.
Mit einem QDevice steht dort dessen Zustand (A,V,NMW oder NR), und der Name
rutscht eine Spalte weiter - gemeldet wurden damit die Zustandskuerzel und
das QDevice als zusaetzlicher vierter Knoten.

Die Namensspalte wird jetzt aus der Kopfzeile bestimmt, die Zeile des QDevice
(Nodeid 0) uebersprungen. Beide Ausgabeformen sind als Testfall hinterlegt.

Agent-Version 0.2.2.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-10-03 18:11:38 +02:00
co-authored by Claude Opus 5
parent 02845ed717
commit 8e5bf74a30
8 changed files with 92 additions and 7 deletions
+40
View File
@@ -0,0 +1,40 @@
# #042 Cluster-Knoten falsch gelesen, wenn ein QDevice im Spiel ist
**Status:** erledigt
**Meilenstein:** v0.24.1
**Labels:** bug, agent
**Geschätzt:** 1 h **Tatsächlich:** 0 h 20 min
## Auslöser
Florians Cluster hat drei Knoten (`hv-pve-01`, `hv-pve-02`, `hv-pve-05`). ProxLedger zeigte vier
„Cluster-Knoten“: `A,V,NMW`, `A,V,NMW`, `NR` und `Qdevice`.
## Ursache
Der Agent nahm aus `pvecm nodes` blind die dritte Spalte als Namen. Ohne QDevice stimmt das:
```
Nodeid Votes Name
1 1 hv-rz5-pve-01 (local)
```
Mit QDevice steht dort aber dessen Zustand, und der Name rutscht eine Spalte weiter:
```
Nodeid Votes Qdevice Name
1 1 A,V,NMW hv-pve-01
0 1 Qdevice (votes 1)
```
Gemeldet wurden damit die Zustandskürzel – und das QDevice selbst als vierter „Knoten“.
## Behebung
Die Spalte „Name“ wird aus der Kopfzeile bestimmt, statt sie zu erraten. Die Zeile des QDevice trägt
die Nodeid 0 und wird übersprungen. Beide Ausgabeformen sind als Testfall hinterlegt.
## Folgen
Die Warnregel „Cluster-Knoten ohne Agent“ hatte dadurch Warnungen für Knoten erzeugt, die es nicht
gibt. Sie schließen sich von selbst, sobald die Agents mit der neuen Fassung gemeldet haben.
## Lehre
Dritter Fall in dieser Reihe: Eine Ausgabe, die beim Feldtest auf **einem** Cluster richtig gelesen
wurde, ist nicht auf jedem Cluster gleich. Spalten gehören über ihre Überschrift angesprochen, nicht
über ihre Position.
+2 -1
View File
@@ -45,4 +45,5 @@ Details und Architektur: [../architektur.md](../architektur.md). Zeiten werden a
| [#039](039-zugang-zur-laufzeit.md) | Auf dem Telefon führte kein Weg zur Laufzeit | erledigt | v0.22.2 | 1 h | 0 h 30 min |
| [#040](040-schlagworte-sichtbar.md) | Schlagworte und Notizen sichtbar machen | erledigt | v0.23.0 | 2 h | 0 h 40 min |
| [#041](041-doppelte-hosts.md) | Gleichnamige Hosts erkennen und stilllegen | erledigt | v0.24.0 | 3 h | 0 h 50 min |
| | **Summe** | | | **168 h** | **22 h 33 min** |
| [#042](042-qdevice-cluster.md) | Cluster-Knoten falsch gelesen bei QDevice | erledigt | v0.24.1 | 1 h | 0 h 20 min |
| | **Summe** | | | **169 h** | **22 h 53 min** |