30020 - Vereinsheim-Alarmmonitor (Banana Pi M2 Ultra)
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/3-apps-workloads/30020-vereinsheim-alarmmonitor.md
Vereinsheim-Alarmmonitor (Banana Pi M2 Ultra)
Zweiter Alarmmonitor-Standort, aber auf anderer Hardware/OS als die
Raspberry-Pi-Flotte aus capulus-core/3-apps-workloads/30010-alamos-apager.md:
ein Banana Pi M2 Ultra mit Armbian statt Raspberry Pi OS, und — anders
als alle anderen Pis in diesem Repo — nach der Ersteinrichtung nur noch per
Tailscale am Netz, ohne direkten LAN-Zugriff zum Homeserver-Netz. Dieses
Dokument beschreibt nur die Abweichungen/Ergänzungen; die Grundarchitektur
(Chromium-Kiosk gegen alamos-apager, Standort-URL als SealedSecret,
Heartbeat → ntfy) ist identisch und dort beschrieben.
Zusätzlich zur Basis-Architektur hat dieser Standort drei Erweiterungen,
die es bei den Raspberry Pis bewusst nicht gibt:
- Tailscale-only-Netzwerk — kein direktes LAN, Zugriff auf
*.homeserverläuft über Tailscale Split-DNS + eine genehmigte
Subnetz-Route. - Lokaler Server-Fallback — springt bei Nichterreichbarkeit von
alamos-apager.prod.homeserverautomatisch auf die echte AMweb-URL. - Grafana-Monitoring + Zammad-Ticket bei Ausfall — taucht im
Dashboards im Ordner "Hardware" auf (per Push, nicht Pull — siehe
unten) und erzeugt (nur für dieses Gerät) ein Zammad-Ticket, wenn es
länger als 10 Minuten nicht erreichbar ist. Online/Offline, CPU, RAM, Temperatur,
Festplatte und Uptime stehen im Dashboard "Mainboard" (Ordner "Hardware"), die
Lebensdauer der SD-Karte unter "Speicher & Laufwerke". Das frühere Standort-Dashboard
"1002011-pis" ist entfallen (ALAMOS-Statuswerte dort inklusive); der
Rhein-Pegel bleibt im Dashboard "Rhein-Pegel Andernach".
Inhaltsverzeichnis
- OS
- Netzwerk: Tailscale-only
- Ersteinrichtung (manuell)
- Ansible-Provisionierung
- Server-Fallback
- Periodischer Seiten-Neustart
- Grafana (Push statt Pull)
- Zammad-Ticket via n8n
- Sichtprüfung ohne physischen Zugriff
- Wake-on-LAN für den Windows-PC
- Fehlerbehebung
OS
Armbian, Debian 13 "Trixie" (minimal/CLI-Image), Kernel 6.18.x —
aktuell "Community Supported" für den Banana Pi M2 Ultra
(https://armbian.com/boards/bananapim2ultra).
Debian minimal statt des ebenfalls angebotenen Ubuntu-Xfce-Images, weil
Ubuntu chromium nur noch als Snap ausliefert (Sandbox-Eigenheiten,
langsamer Erststart) — Debian hat weiterhin ein echtes .deb-Paket, das
sich sauber per Ansible/apt installieren lässt.
Netzwerk: Tailscale-only
Anders als die xibosignage-Pis (die volles LAN haben und Tailscale nur zur
bequemen Fernwartung nutzen, siehe capulus-core/3-apps-workloads/300e0-xibosignage.md)
hat dieser Standort kein LAN-Zugriff zum Homeserver-Netz. Das betrifft
drei unabhängige Dinge, die alle einzeln gelöst werden mussten:
1. Ansible/Semaphore-Erreichbarkeit (Henne-Ei-Problem). Ansible kann
Tailscale nicht per Ansible installieren, wenn Tailscale der einzige Weg
zum Gerät ist. Deshalb zwei Phasen:
- Phase 1 (Ersteinrichtung): Pi hängt kurz am LAN,
ansible_host= LAN-IP (192.168.178.129). Der erste
make banana-pi-kiosks-Lauf installiert dabei auch Tailscale
(capulus-ansible/roles/tailscale, siehecapulus-ansible/group_vars/banana_pis.yml
für den eigenen Tailscale-Auth-Key — nicht den Homeserver-Key aus
group_vars/all.ymlwiederverwenden). - Phase 2 (Dauerbetrieb): Nach dem Umzug an den eigentlichen Standort
ansible_hostincapulus-ansible/inventory/hosts.ymlauf die Tailscale-IP
(tailscale ip -4auf dem Pi) oder den MagicDNS-Namen umstellen.
Wichtig: Semaphore läuft selbst als Pod im k3s-Cluster und hat wie
jeder Pod keinen Netzwerkpfad zu Tailscale-Peers — Re-Provisionierung
in Phase 2 funktioniert nur noch permake banana-pi-kiosksvon einer
im Tailnet angemeldeten Maschine, nicht mehr über die Semaphore-UI.
2. DNS-Auflösung von *.homeserver (für den Kiosk selbst). Gelöst über
Tailscale Split-DNS, ein dokumentiertes, bereits unterstütztes
Verfahren in diesem Repo (siehe
capulus-ansible/b-kubernetes-gitops/b0030-semaphore.md, "Zugriff über Tailscale"
und capulus-core/c-netzwerk-dns/c0000-dns-architecture.md): dnsmasq auf dem
Homeserver lauscht bereits auf tailscale0. Einmaliger Admin-Schritt:
Tailscale-Adminkonsole → DNS → Nameservers → Custom Nameserver mit der
Tailscale-IP des Homeservers, restricted to search domain homeserver
hinzufügen. Danach löst der Pi alamos-apager.prod.homeserver etc. korrekt auf
(Antwort ist weiterhin eine LAN-IP, siehe Punkt 3).
3. Tatsächliche Erreichbarkeit der aufgelösten LAN-IP. Die DNS-Antwort
bringt nichts, wenn der Pi die LAN-IP dahinter nicht routen kann. Der
Homeserver bewirbt bereits 192.168.178.0/24 als Subnetz-Route
(capulus-ansible/roles/tailscale, Default über group_vars/all.yml) — die muss
im Tailscale-Adminpanel genehmigt sein
(https://login.tailscale.com/admin/machines). Der Pi selbst muss diese
Route zusätzlich annehmen: tailscale_accept_routes: true in
capulus-ansible/group_vars/banana_pis.yml (Default für alle anderen Hosts in
diesem Repo ist false — die Rolle wurde dafür erweitert, siehe
capulus-ansible/roles/tailscale/defaults/main.yml).
Nebenbei behoben: Die tailscale-Rolle war bisher hart auf das
Ubuntu-APT-Repo von Tailscale kodiert (pkgs.tailscale.com/stable/ubuntu/...).
Armbian meldet sich als Debian — die Rolle wählt jetzt automatisch das
richtige Repo (tailscale_repo_os, siehe Rollen-Defaults).
Ersteinrichtung (manuell)
Reines Imaging, kein Ansible-Thema (analog zu "Raspberry Pi OS Desktop +
Autologin" bei den anderen Kiosks):
- Armbian-Image auf SD/eMMC flashen.
- Erstboot: Root-Login, Kiosk-User anlegen (hier
pela, siehe
banana_pi_kiosk_userincapulus-ansible/roles/banana_pi_kiosk/defaults/main.yml). - Netzwerk/SSH so einrichten, dass der Host noch am LAN per
ansible_hostaus dem Inventory (192.168.178.129, Phase 1) erreichbar
ist — siehe Netzwerk: Tailscale-only. make semaphore-targetslaufen lassen (pusht den Semaphore-SSH-Key,
Host ist bereits untersemaphore_targetsin
capulus-ansible/inventory/hosts.ymleingetragen). Funktioniert nur in Phase 1.
Autologin auf tty1 sowie die minimale X11-Session (Xorg + Openbox, kein
Desktop-Environment) richtet — anders als bei den Raspberry Pis, wo das
der Raspberry Pi Imager übernimmt — die Ansible-Rolle
capulus-ansible/roles/banana_pi_kiosk selbst ein (getty-Drop-in +
.bash_profile + .xinitrc).
Ansible-Provisionierung
make banana-pi-kiosks-check # Dry-run
make banana-pi-kiosks # Provisionieren
Rollen, in dieser Reihenfolge (siehe capulus-ansible/banana-pi-kiosks.yml):
| Rolle | Zweck |
|---|---|
tailscale |
Netzwerk-Anbindung (siehe oben) — läuft zuerst, alles Weitere braucht ggf. schon *.homeserver |
node_exporter |
Metriken-Quelle (Port 9100, nur lokal) |
vmagent |
Pusht die Metriken aktiv an den Cluster (siehe Grafana) |
banana_pi_kiosk |
X11-Autologin, Chromium-Kiosk, Server-Fallback-Supervisor, Heartbeat, täglicher Kiosk-Session-Neustart um 00:00 Uhr (kein Kernel-Reboot, siehe 60020 — Warm-Reset auf diesem Board unzuverlässig) |
thermal_watchdog |
Selbstschutz bei Übertemperatur (gleiches Bundling wie bei den Alamos-Pis) |
resource_watchdog |
Selbstschutz bei CPU/RAM-Sättigung |
Vor dem ersten Lauf nötig:
- Standort-URL im Cluster hinterlegen — Key
vereinsheim-alarmmonitor
zum SealedSecretalamos-apager-stationshinzufügen (siehe
capulus-core/3-apps-workloads/30010-alamos-apager.md, "Neuen Standort hinzufügen"). - Dieselbe URL lokal verschlüsseln (Fallback, siehe unten):
Ausgabe inansible-vault encrypt_string 'https://amweb.alamos.cloud/...echte-url...' \ --name 'vault_vereinsheim_alarmmonitor_fallback_url'capulus-ansible/host_vars/vereinsheim-alarmmonitor/vault.yml
anstelle desCHANGE-ME-Platzhalters einfügen. - Eigener Tailscale-Auth-Key in
capulus-ansible/group_vars/banana_pis.yml
(Ansible-Vault-verschlüsselt, Ablauf in 60010 — nicht den
Homeserver-Key wiederverwenden). - Tailscale-Adminkonsole: Split-DNS + Subnetz-Route-Genehmigung, siehe
Netzwerk: Tailscale-only. - Einmaliger manueller AMweb-Login direkt am Gerät (Passwort +
Verschlüsselungspasswort) — identisches Vorgehen wie bei den Raspberry
Pis, siehe capulus-core/3-apps-workloads/30010-alamos-apager.md, Pi-Provisionierung.
Da Normal- und Fallback-Pfad dieselbe AMweb-Domain im selben
Chromium-Profil verwenden, deckt dieser eine Login beide Pfade ab.
Server-Fallback
Bewusster Bruch mit der sonst geltenden Regel "die echte AMweb-URL
verlässt nie den Cluster" (capulus-core/3-apps-workloads/30010-alamos-apager.md)
— nur für dieses Gerät, auf ausdrücklichen Wunsch.
capulus-ansible/roles/banana_pi_kiosk/templates/banana-pi-kiosk-supervisor.sh.j2
ist der X-Session-Client (läuft dauerhaft, damit xinit die Session nicht
beendet) und:
- prüft alle 30s (
banana_pi_kiosk_failover_poll_seconds) die
Erreichbarkeit vonalamos-apager.prod.homeserver, - schaltet nach 3 aufeinanderfolgenden Fehlversuchen (~90s,
banana_pi_kiosk_failover_fail_threshold) auf die lokal (Ansible-Vault)
hinterlegte echte AMweb-URL um, - schaltet nach dem ersten erfolgreichen Check
(banana_pi_kiosk_failover_recover_threshold) wieder auf die normale
Cluster-URL zurück, - startet Chromium dafür jeweils neu (gleiches Profil, kein
--incognito→ Session/Login bleibt erhalten), ohne die X-Session
selbst neu zu starten.
Der bestehende Heartbeat-Timer (→ ntfy-Ausfall-Alarm in
argocd/apps/tech/alamos-apager) läuft unverändert parallel und unabhängig
davon weiter — er braucht denselben *.homeserver-Pfad wie der Kiosk
selbst, ist also von derselben Split-DNS/Route-Voraussetzung abhängig.
Periodischer Seiten-Neustart
Hintergrund: Am 2026-09-12 wurde ein echter Einsatzalarm auf diesem
Monitor nicht angezeigt. Die Nachanalyse (~4 Tage später) konnte den
Vorfall mangels Retention nicht mehr rekonstruieren (lokales journalctl
nur ~3,5 Tage, ntfy-Topic-Cache nur ~12h — Anlass für
capulus-core/3-apps-workloads/300j0-logging.md). Geprüft und
ausgeschlossen wurde dabei, dass sich die Standort-URL pro Alarm
ändert: /start?station=... löst serverseitig immer zur selben, fest im
SealedSecret hinterlegten AMweb-URL auf (siehe
capulus-core/3-apps-workloads/30010-alamos-apager.md) —
neue Alarme sollen live innerhalb derselben, dauerhaft offenen
Chromium-Session erscheinen, nicht über einen neuen Redirect.
Verbleibende Hypothese (nicht abschließend bestätigt): Chromium bleibt
bis zu 24h ununterbrochen offen (bisher nur täglicher
getty@tty1-Neustart um 00:00, siehe
Ansible-Provisionierung). Bleibt die Seite
äußerlich normal sichtbar, während ihre eigene In-Page-Live-Aktualisierung
(Websocket/Polling) lautlos hängen bleibt, greift keiner der
bestehenden Sicherheitsmechanismen: alamos-apager selbst bleibt
erreichbar (kein Fallback-Trigger), der Heartbeat-Timer läuft unabhängig
vom Seiteninhalt weiter (kein Down-Alarm), und es gibt keinen Login-Screen
(keine abgelaufene Session).
Mitigation (Feature vorhanden, aktuell deaktiviert): Der Supervisor
(capulus-ansible/roles/banana_pi_kiosk/templates/banana-pi-kiosk-supervisor.sh.j2)
kann Chromium zusätzlich alle banana_pi_kiosk_periodic_refresh_seconds
Sekunden neu starten (Rollen-Default in
capulus-ansible/roles/banana_pi_kiosk/defaults/main.yml) — unabhängig von
Fallback-Zustand und Crash-Erkennung, per stop_chromium/start_chromium
(gleiche Funktionen wie beim Fallback-Wechsel, also gleiches
Profil/gleiche Session, kein erneuter Login nötig). Der Timer wird bei
jedem Chromium-(Neu-)Start zurückgesetzt (auch bei Fallback-Wechsel oder
Crash-Recovery), es gibt also nie einen Neustart kurz nach einem anderen.
banana_pi_kiosk_periodic_refresh_seconds: 0 deaktiviert das Feature
vollständig — das ist seit 2026-09-16 der Rollen-Default. Damit ist die
oben beschriebene Hypothese (stiller Hänger der In-Page-Live-Aktualisierung)
wieder ungemindert; bewusste Entscheidung gegen die störenden
periodischen Neustarts. Zum Reaktivieren einen Wert > 0 setzen, z. B.
banana_pi_kiosk_periodic_refresh_seconds: 7200 (120 Minuten, der frühere
Default) in capulus-ansible/host_vars/vereinsheim-alarmmonitor/.
Loggt bei jedem periodischen Neustart eine Zeile über
logger -t banana-pi-kiosk (siehe
capulus-core/3-apps-workloads/300j0-logging.md für die
zentrale Abfrage über VictoriaLogs statt des kurz laufenden lokalen
Journals).
Grafana (Push statt Pull)
Anders als bei ugreen-nas (VMStaticScrape, Cluster scraped aktiv):
Pods im Cluster (Pod-Netz 10.42.0.0/16) haben keinen Netzwerkpfad zu
Tailscale-Peers — kein Subnet-Router ins Pod-Netz, --accept-routes=false
überall sonst im Repo. Cluster-seitiges Scrapen scheidet für diesen Host
also aus.
Stattdessen pusht der Pi seine Metriken selbst:
node_exporter (Port 9100, nur localhost)
→ vmagent (capulus-ansible/roles/vmagent, scraped lokal)
→ remote_write über https://vm-write.tech.homeserver/api/v1/write
(argocd/apps/tech/monitoring/templates/ingress-vm-write.yaml,
nur /api/v1/write freigegeben, nicht die volle VM-API)
→ VictoriaMetrics im Cluster
Das nutzt denselben Netzwerkpfad (Split-DNS + Subnetz-Route), den der Kiosk
ohnehin schon braucht — kein zusätzliches Pod-zu-Tailscale-Routing nötig.
vmagent ist eine statische Binary (kein Debian-Paket verfügbar,
vmutils-linux-arm-v*.tar.gz vom GitHub-Release), puffert bei kurzzeitiger
Nichterreichbarkeit lokal (-remoteWrite.tmpDataPath) und holt das dann
nach.
Push-Pfad: https und eine Queue (Vorfall 26.09.2026): Der Pi lieferte
stundenlang keine Hardware-Daten (Heartbeat lief weiter), und vmalert im
Cluster meldete RemoteWriteDroppingData. Zwei zusammenwirkende Ursachen:
http://statthttps://invmagent_remote_write_url. Der TECH-Traefik
leitet HTTP global per 308 auf HTTPS um,vmagentfolgt der Weiterleitung —
jeder Push besteht also aus zwei Etappen. Die erste (Port 80) hängt vom Pi
aus reproduzierbar, sobald der Body größer als ~12 KB ist (≤ 4 KB gehen
durch): 20 KB überhttpbrauchten 9–40 s oder liefen ins Timeout, über
httpsdirekt ~1 s. Dievmagent-Blöcke sind ~20 KB groß. Warum Port 80
hängt, ist nicht abschließend geklärt (Vermutung: Traefik antwortet mit 308,
ohne den Body zu lesen). Gleiches Muster wie beim Journal-Upload
(300j0-logging.md).- Zu viele parallele Queues.
vmagentnutzt standardmäßig2 × CPU-Kerne
Queues (Pi: 8). VictoriaMetrics hält pro Insert-Request einen Slot, solange
der Client noch sendet, und erlaubt bei 1000m CPU nur 2 gleichzeitige
(maxConcurrentInserts). Haken mehrere Pi-Requests, wartet auchvmalertbis
zum Timeout auf einen Slot und verwirft seine Daten
(vm_concurrent_insert_limit_reached_totalsteigt).
Daher setzt die Rolle -remoteWrite.queues=1 (Normalbetrieb ~1 KB/s), die
Gruppen-Variable steht auf https://, und vmsingle erlaubt
maxConcurrentInserts: 16. Der Pi-Teil wirkt erst nach make banana-pi-kiosks;
der lokal gepufferte Backlog wird danach nachgeliefert.
Kein Dashboard-Change nötig — die Hardware-Dashboards (Ordner "Hardware",
Hardware-Monitoring)
filtern dynamisch über das Label host; der Pi taucht automatisch auf, sobald
seine Metriken mit host/kind ankommen. Die Labels ergänzt VictoriaMetrics
beim Empfang (argocd/apps/tech/monitoring/templates/configmap-vmsingle-relabel.yaml),
die vmagent-Rolle (capulus-ansible/roles/vmagent/templates/vmagent-scrape.yml.j2)
setzt sie ab dem nächsten make banana-pi-kiosks zusätzlich selbst — ein
Ansible-Lauf gegen den Pi ist dafür nicht nötig. Das frühere Standort-Dashboard "1002011-pis" mit eigenen Detail-Panels ist entfallen.
Zammad-Ticket via n8n
Nur für diesen Standort — die Raspberry-Pi-Alarmmonitore erzeugen
weiterhin bewusst kein Ticket pro Ausfall (nur ntfy, siehe
capulus-core/3-apps-workloads/30010-alamos-apager.md); das bleibt unverändert.
Wichtig, wegen Push statt Pull: Die VMRule nutzt absent_over_time
statt up == 0 — ein up-Sample mit Wert 0 setzt eine laufende
Scrape-Verbindung voraus, die es hier gar nicht gibt (der Pi pusht ja
selbst). Fällt er aus, hört die Zeitreihe einfach auf, sich zu
aktualisieren; absent_over_time erkennt "seit 10 Minuten kein Sample
mehr angekommen" — das erfasst sowohl "Pi ist down" als auch "Pi lebt,
aber Tailscale/Push-Pfad ist down" (aus Nutzersicht ohnehin dasselbe
Problem: der Monitor ist nicht mehr überwachbar).
Ablauf:
absent_over_time(up{...}[10m]) für vereinsheim-alarmmonitor
→ VMRule "BananaPiAlarmmonitorDown" (vmrule-banana-pi.yaml, severity=critical)
→ Alertmanager, zusätzliche Route NUR für diesen Alertnamen
(argocd/apps/tech/monitoring/values.yaml)
→ n8n-Webhook https://n8n.prod.homeserver/webhook/banana-pi-down
→ Workflow "Banana-Pi-Down -> Zammad-Ticket"
(argocd/apps/tech/n8n/workflows/banana-pi-down-to-zammad.json):
1. letzte bekannte CPU/RAM/Temperatur-Werte aus VictoriaMetrics holen
(der Pi selbst ist ja gerade nicht erreichbar — das sind KEINE
Live-Daten, sondern der letzte Stand vor dem Ausfall)
2. Zeitstempel der letzten erfolgreichen /start-Anfrage holen (=
wann hat der Kiosk zuletzt die echte AMweb-URL angefragt) —
kommt NICHT vom Pi, sondern von alamos-apager selbst
(`/metrics`, siehe capulus-core/3-apps-workloads/30010-alamos-apager.md), das immer im
Cluster läuft und daher unabhängig vom Tailscale-Status des Pi
abfragbar ist
3. Zammad-Ticket erstellen (POST /api/v1/tickets, gleiches Muster
wie argocd/apps/tech/github-release-watcher)
→ Zammads eigene Agenten-Benachrichtigung verschickt die Mail an
[email protected] (kein separater E-Mail-Node in n8n nötig)
Die bestehende ntfy-Route bleibt für diesen Alert (und alle
anderen) unverändert bestehen — die n8n-Route kommt rein additiv dazu
(continue: true, siehe 60060).
Achtung, Bedeutung des Werts: Der Zeitstempel der letzten /start-Anfrage
ist ein Browser-Start-Marker, kein Lebenszeichen. /start wird nur
aufgerufen, wenn Chromium (neu) startet (Reboot, Absturz, Fallback-Wechsel);
danach hält der Browser die AMweb-Seite dauerhaft offen. Ein Wert von
10 h oder mehr ist daher normal und wächst bis zum nächsten Neustart. Im
früheren Dashboard "1002011-pis" hieß das Panel deshalb "Letzter Browser-Start"
(neutral blau, ohne Alarmfarbe); massgeblich für "lebt der Monitor" ist das
Panel "Letztes Lebenszeichen (Heartbeat)" (grün < 2 min, gelb ab 2 min, rot
ab 5 min). Im Zammad-Ticket-Workflow unten steht dieser Wert ebenfalls unter
der Bezeichnung "Letzte AMweb-Anfrage" — gemeint ist dort der letzte
Browser-Start.
Woher "letzte AMweb-Anfrage" kommt: alamos-apager (die geteilte
Cluster-Komponente aus capulus-core/3-apps-workloads/30010-alamos-apager.md)
merkt sich jetzt zusätzlich zum Heartbeat auch den Zeitstempel jeder
erfolgreichen /start-Anfrage (also wann der Kiosk-Browser zuletzt
tatsächlich die echte AMweb-URL angefragt hat) und exportiert das über
einen eigenen /metrics-Endpunkt (alamos_apager_last_start_timestamp_seconds,
siehe argocd/apps/tech/alamos-apager/templates/configmap-script.yaml +
vmservicescrape.yaml). Das läuft cluster-intern und ist damit — anders
als die node_exporter-Metriken des Pi selbst — auch dann abfragbar, wenn
der Pi/Tailscale gerade down ist. Betrifft alle Alamos-Standorte
gleichermaßen, nicht nur diesen.
Einmalige manuelle Schritte:
- Zammad:
[email protected]als Agent-Account anlegen (falls noch
nicht vorhanden), Mitglied der Ticket-Gruppe (Default im Workflow:
Support::Administration— angenommen als Untergruppe "Administration"
von "Support",::ist der von der Zammad-API erwartete Trenner für
Untergruppen, siehe capulus-core/f-cicd-automatisierung/f0040-github-release-watcher.md; falls es
stattdessen eine einzelne Gruppe mit dem wörtlichen Namen
"Support / Administration" ist, im Code-Node "Ticket-Payload bauen"
entsprechend anpassen) machen und unter Profil → Benachrichtigungen
die Mail-Benachrichtigung
für "Neues Ticket" aktivieren (Zammad-Standard: aktiviert). Gleiches
Prinzip wie capulus-core/f-cicd-automatisierung/f0040-github-release-watcher.md, Schritt 4. - Zammad-API-Token erzeugen: Profil → Token Access → Neuer Token,
Berechtigungticket.agent(siehe
capulus-core/f-cicd-automatisierung/f0040-github-release-watcher.md, Schritt 1
für die genauen Klicks). - n8n: Workflow
banana-pi-down-to-zammad.jsonimportieren, dann im
Node "Zammad-Ticket erstellen" eine Header-Auth-Credential anlegen/
zuweisen (Name z. B. "Zammad API Token", Header-NameAuthorization,
ValueToken token=<ZAMMAD_TOKEN>aus Schritt 2) — Credential-IDs
werden beim Import nicht mit übernommen, das ist ein normaler
Post-Import-Schritt.
Im Node „Alertmanager Webhook“ das CredentialWebhook banana-pi-down
(Header Auth) zuweisen. Alertmanager sendet das Token als
Authorization: Beareraus dem Secretn8n-webhook-token
(Namespacemonitoring), siehe
30070. - Workflow in n8n aktivieren (
active: truein der UI).
Sichtprüfung ohne physischen Zugriff
Für dieses Gerät ist bewusst kein dauerhafter Remote-Zugriff (VNC o. Ä.)
eingerichtet — anders als bei den Hardware-Checks über journalctl/ps
lässt sich die visuelle Korrektheit der Anzeige damit nicht automatisiert
prüfen. Stattdessen ein On-Demand-Screenshot-Skript
(capulus-ansible/roles/banana_pi_kiosk/templates/banana-pi-screenshot.sh.j2), das
nur bei Bedarf per SSH läuft — kein Timer, kein dauerhaft offener Port:
ssh pela@vereinsheim-alarmmonitor banana-pi-screenshot.sh
scp pela@vereinsheim-alarmmonitor:/home/pela/kiosk-screenshot.png .
Nutzt scrot gegen DISPLAY=:0 (die X-Session des Kiosk-Users) und
überschreibt bei jedem Aufruf dieselbe Datei.
Wake-on-LAN für den Windows-PC
Ein Windows-PC hängt per LAN am selben Router/Repeater wie dieser Pi.
Semaphore/n8n können ihn nicht direkt aufwecken (kein Pfad zu
Tailscale-Peers, siehe oben) — stattdessen verschickt der Pi selbst das
Magic Packet lokal ins Standort-LAN, ausgelöst manuell per SSH von jeder
Tailnet-Maschine, analog zum Screenshot-Skript unten:
ssh pela@vereinsheim-alarmmonitor banana-pi-wol.sh windows-pc
MAC-Adressen-Tabelle: capulus-ansible/host_vars/vereinsheim-alarmmonitor/vars.yml
(banana_pi_kiosk_wol_devices, Alias → MAC). Rollen-Implementierung:
capulus-ansible/roles/banana_pi_kiosk/templates/banana-pi-wol.sh.j2 +
capulus-ansible/roles/banana_pi_kiosk/tasks/main.yml (Kill-switch
banana_pi_kiosk_wol_enabled).
Voraussetzungen (einmalig, nicht per Ansible automatisierbar):
- Auf dem PC: WoL im BIOS/UEFI aktivieren, NIC-Eigenschaften → "Wake on
Magic Packet" aktivieren, Windows-Schnellstart deaktivieren (sonst
wird beim "Herunterfahren" nur hybrid-hibernated, NIC bleibt nicht
empfangsbereit). - Pi und PC müssen im selben L2-Segment/Subnetz hängen (
ip aauf dem Pi
vs. IP des PCs vergleichen) — sonst kommt der Broadcast nicht an. - Client-/AP-Isolation im Router-/Repeater-WebUI muss deaktiviert sein,
sonst wird jede Geräte-zu-Geräte-Kommunikation (auch der Broadcast)
geräuschlos verworfen, obwohl beide im selben Netz hängen.
Architektur-Hintergrund und der geplante Router-VPN-Fallback (für den
Fall, dass der Pi selbst nicht erreichbar ist) stehen in
capulus-core/4-planung/40020-vereinsheim-wol-router-vpn.md.
iOS-App
Die "Homeserver Dashboard"-App hat im Tab "Steuerung" einen eigenen
"Aufwecken"-Button für den Windows-PC. Anders als bei worker-0/worker-1
läuft das nicht über carplay-api (der Cluster-Pod hat keinen Pfad zu
Tailscale-Peers) — die App spricht stattdessen einen kleinen HTTP-Agenten
(banana-pi-wol-agent, Teil der banana_pi_kiosk-Rolle) direkt über die
Tailscale-IP des Pi an, Port 9102, Bearer-Token-gesichert. Der Agent ruft
intern nur banana-pi-wol.sh auf — keine doppelte MAC-Verwaltung.
Der Agent spricht HTTPS (https://100.123.214.4:9102) mit einem Zertifikat der
Homeserver-Root-CA, das die IP als Subject Alternative Name trägt, und lauscht
ausschließlich auf der Tailscale-Adresse des Pi
(banana_pi_kiosk_wol_agent_bind_address). Die App vertraut ihm über dieselbe
Root-CA wie carplay-api. Ausstellung, Hinterlegung und Erneuerung des
Zertifikats: d0040,
Hintergründe: 60080.
Token für die App-Einstellungen auslesen:
ssh pela@vereinsheim-alarmmonitor sudo cat /etc/banana-pi-wol-agent/token
In der App: Zahnrad-Symbol → "Vereinsheim-WoL-Agent-Token" → einfügen →
"In Keychain speichern".
Bewusster Kompromiss mit dem sonst geltenden Prinzip "kein dauerhaft
offener Port" auf diesem Pi — Details und Begründung in
capulus-core/4-planung/40020-vereinsheim-wol-router-vpn.md.
Kill-switch: banana_pi_kiosk_wol_agent_enabled: false (behält nur den
SSH-Weg).
Online-Status prüfen und den PC wieder herunterfahren: siehe
capulus-core/3-apps-workloads/30021-vereinsheim-windows-pc-steuerung.md.
Fehlerbehebung
| Symptom | Check |
|---|---|
make banana-pi-kiosks erreicht den Pi nicht mehr |
Phase 1 vs. Phase 2? ansible_host in capulus-ansible/inventory/hosts.yml noch auf der alten LAN-IP, obwohl der Pi schon umgezogen ist? |
| Kiosk zeigt weder Redirect noch Fallback (Chromium-Fehlerseite) | nslookup alamos-apager.prod.homeserver auf dem Pi — löst das auf? Tailscale Split-DNS eingerichtet (siehe oben)? |
| DNS löst auf, aber Verbindung timeout | Subnetz-Route 192.168.178.0/24 im Tailscale-Adminpanel genehmigt? tailscale_accept_routes: true beim Pi angekommen (tailscale status auf dem Pi prüfen)? |
| Pi taucht nicht in Grafana auf | systemctl status vmagent auf dem Pi, journalctl -u vmagent — Fehler beim remote_write? curl -I https://vm-write.tech.homeserver/api/v1/write vom Pi aus erreichbar? |
Pi ist online, Lebenszeichen kommen, aber keine CPU/Hardware-Daten und Alert RemoteWriteDroppingData (26.09.2026) |
Der Heartbeat ist winzig und kommt durch, die vmagent-Blöcke (~20 KB) nicht. Auf dem Pi: journalctl -u vmagent → Client.Timeout exceeded while awaiting headers; grep vm-write /etc/systemd/system/vmagent.service — steht dort http://? Dann läuft jeder Push über den hängenden 308-Umweg, siehe Grafana (Push statt Pull). Backlog: curl -s localhost:8429/metrics \| grep pending_data_bytes. Transport-Gegentest vom Pi: curl -s -o /dev/null -w '%{time_total}\n' -X POST --data-binary @<20-KB-Datei> https://vm-write.tech.homeserver/x (~1 s) gegenüber http://… (Timeout). Im Cluster: vm_concurrent_insert_limit_reached_total von vmsingle steigt, wenn Pi-Requests die Insert-Slots belegen. Hinweis: Große Pings über Tailscale verlieren hier 50–80 %, TCP über 443 läuft trotzdem sauber — Ping ist kein Maßstab |
| Kiosk startet nicht / schwarzer Bildschirm | systemctl status getty@tty1 auf dem Pi, Autologin aktiv? Läuft startx? |
| Fallback schaltet nicht um | journalctl -t banana-pi-kiosk auf dem Pi (Supervisor loggt Moduswechsel) |
| Fallback zeigt AMweb-Login statt Alarmmonitor | Chromium-Session abgelaufen — einmaligen manuellen Login wiederholen (siehe oben) |
| Dashboard zeigt "Letzter Browser-Start" vor > 10 h | Normal: /start kommt nur bei Chromium-Start (siehe Hinweis im Abschnitt Zammad-Ticket). Lebenszeichen prüfen: Panel "Letztes Lebenszeichen (Heartbeat)" bzw. alamos_apager_last_heartbeat_timestamp_seconds |
Alert BananaPiAlarmmonitorDown feuert, obwohl der Pi läuft (Ausfall 18.–19.09.2026, ~37 h) |
Pfad Pi → Cluster prüfen, nicht den Pi selbst: journalctl -u tailscaled auf dem Homeserver nach Drop: TCP{100.123.214.4 …} no rules matched (Tailscale-ACL/Subnetz-Route für 192.168.178.0/24). Metriken werden vom vmagent nachgeliefert, der Verlauf sieht danach lückenlos aus, der Alarm feuerte aber in Echtzeit |
| Kein Zammad-Ticket trotz 10+ Minuten Ausfall | kubectl -n monitoring get vmrule banana-pi-availability (Alert "firing"?), Alertmanager-Route korrekt? n8n-Workflow aktiv? |
| Ticket erstellt, aber keine Mail | Zammad-Agent-Mitgliedschaft/Benachrichtigung prüfen (siehe oben), ausgehender E-Mail-Kanal in Zammad konfiguriert? |
| n8n-Workflow schlägt am Zammad-Node fehl | Header-Auth-Credential zugewiesen? Token gültig/ticket.agent-Berechtigung? |
banana-pi-wol.sh läuft durch, PC wacht trotzdem nicht auf |
WoL im BIOS/NIC des PCs aktiv? Windows-Schnellstart deaktiviert? Client-/AP-Isolation im Router/Repeater aktiv? Pi und PC wirklich im selben Subnetz (ip a)? |
| iOS-App: "Aufwecken" bei Windows-PC schlägt fehl (401) | Token in der App aktuell? Neu auslesen: ssh pela@vereinsheim-alarmmonitor sudo cat /etc/banana-pi-wol-agent/token |
iOS-App: "Aufwecken" bei Windows-PC meldet einen TLS-/Verbindungsfehler, obwohl curl --cacert pki/homeserver-root-ca.pem -X POST https://100.123.214.4:9102/wol eine HTTP-Antwort liefert |
Root-CA auf dem iPhone installiert und aktiviert? Zertifikat abgelaufen (openssl s_client -connect 100.123.214.4:9102 und openssl x509 -noout -enddate, Eintrag vereinsheim-wol-agent-cert im Token-Register)? App-Build noch mit http:// (der Agent spricht nur HTTPS)? |
| iOS-App: "Aufwecken" bei Windows-PC ohne Antwort/Timeout | Tailscale auf dem Handy aktiv? systemctl status banana-pi-wol-agent auf dem Pi — läuft der Dienst? curl --cacert pki/homeserver-root-ca.pem -X POST https://100.123.214.4:9102/wol -H "Authorization: Bearer <token>" -d '{"target":"windows-pc"}' von einer Tailnet-Maschine zum Gegenchecken |
Nachträgliche Analyse eines Vorfalls (z. B. "Alarm wurde nicht angezeigt") — lokales journalctl reicht nicht mehr zurück |
Journal auf dem Pi ist auf ~3,5 Tage begrenzt (täglicher Reboot + 20-MB-Limit) — stattdessen Grafana/VictoriaLogs abfragen (Retention 14 Tage), siehe capulus-core/3-apps-workloads/300j0-logging.md |
| Prüfen, ob der periodische Chromium-Neustart läuft (nur relevant, falls wieder aktiviert) | journalctl -t banana-pi-kiosk auf dem Pi bzw. in VictoriaLogs nach periodischer Neustart filtern (siehe Periodischer Seiten-Neustart) |
Relevante Links
- capulus-core/3-apps-workloads/30010-alamos-apager.md — Basis-Architektur (Raspberry-Pi-Flotte)
- capulus-core/3-apps-workloads/30021-vereinsheim-windows-pc-steuerung.md — Windows-PC: Online-Check & Herunterfahren
- capulus-ansible/b-kubernetes-gitops/b0030-semaphore.md — Tailscale Split-DNS-Setup
- capulus-core/c-netzwerk-dns/c0000-dns-architecture.md —
*.homeserver-Auflösung - capulus-core/c-netzwerk-dns/c0010-tailscale.md — Tailscale-Grundlagen
- capulus-core/3-apps-workloads/30000-zammad.md — Zammad-Setup
- capulus-core/f-cicd-automatisierung/f0040-github-release-watcher.md — Zammad-API-Ticket-Muster
- capulus-core/3-apps-workloads/30070-n8n.md — n8n-Setup
- capulus-core/2-betrieb-hardware/20000-nas-storage.md — VMStaticScrape-Muster (ugreen-nas, Pull-Vergleichsfall)
- capulus-core/4-planung/40020-vereinsheim-wol-router-vpn.md — Architektur-Plan Wake-on-LAN + Router-VPN-Fallback
- capulus-core/3-apps-workloads/300j0-logging.md — zentrales Logging (VictoriaLogs), löst die kurze lokale Journal-Retention dieses Pi ab
- Armbian — Banana Pi M2 Ultra
- VictoriaMetrics vmagent