Zum Inhalt

Wartung & Troubleshooting

Wartungsrhythmus

Die Intervalle sind Richtwerte. Nach Änderungen, Updates oder auffälligen Messwerten zusätzlich eine manuelle Prüfung durchführen.

Dashboard

Das neue kompakte Wartungsdashboard ist unter Wartungsdashboard wartung-neu dokumentiert. Dort sind Aufbau, Design-Konventionen sowie die Bereiche Heizung, Lüftung, Beschattung, Energie und Sonstiges beschrieben.

Regelmäßige Aufgaben

Aufgabe Intervall Hinweis
ebusd Logs prüfen monatlich du -sh /var/log/ebusd* — bei >500 MB bereinigen
Lüftungsfilter prüfen nach Strombedarf >50 W bei Tag = reinigen
HA Backup automatisch lokale HA-Snapshots auf LocalBackup plus OneDrive; Proxmox sichert Maschinen zusätzlich täglich
Stale Entities prüfen monatlich Registry-/Restored-Altlasten kontrollieren
MikroTik Blocklist prüfen monatlich Scheduler blocklist-daily und Logs prüfen
MikroTik RouterOS-Updates nach Bedarf Stable-Branch prüfen
MikroTik DoH-Bug beobachten nach RouterOS-Update verify-doh-cert=yes testweise beobachten
MCP Audit prüfen bei Bedarf get_audit_logs; unerwartete Tool-Aufrufe oder Fehler erkennen
MCP-Dienste prüfen monatlich/nach Änderungen mcp-audit-writer, mcp-shell, mcp-admin
HA-MCP-Bridge prüfen nach HA-MCP-Update ha_search_tools + harmloser Read-Aufruf über mcp.diebrocks.com, anschließend Audit prüfen
MCP-Server Paketupdates monatlich check_updates auf Host mcp-server
Pool-Saison beenden Saisonende input_boolean.pool_in_betrieb deaktivieren

Log-Bereinigung ebusd

rm -f /var/log/ebusd.log.1-*.backup /var/log/ebusd.log.1
df -h /

Beide ebusd-Container laufen seit Juni 2026 auf Log-Level notice.

MCP-Server

Audit prüfen

Bevorzugt über das MCP-Tool:

get_audit_logs

Direkt auf CT 108:

ls -l /var/log/mcp-audit/
tail -50 /var/log/mcp-audit/$(date -u +%F).jsonl | jq .

Das frühere /var/log/mcp-shell-audit.jsonl gehört nicht mehr zum produktiven Aufbau.

Die Audit-Dateien sind root-eigen. Der Benutzer mcp darf sie lesen, aber nicht direkt schreiben, kürzen oder löschen.

Dienste

# Auf Proxmox
pct exec 108 -- systemctl status mcp-audit-writer mcp-shell mcp-admin --no-pager

Bei einem reinen MCP-Neustart:

pct exec 108 -- systemctl restart mcp-shell

Den Audit-Writer nur neu starten, wenn tatsächlich dessen Dienst oder Code betroffen ist.

HA-Bridge nach Update prüfen

Nach einem Update des Home Assistant MCP Server:

  1. MCP-Verbindung im Client bei Bedarf neu laden.
  2. Über mcp.diebrocks.com mit ha_search_tools ein bekanntes Read-Tool suchen.
  3. Harmlosen Read-Aufruf über ha_call_read_tool ausführen.
  4. Prüfen, dass der äußere Audit-Eintrag Caller/Client enthält und args leer bleibt.
  5. Bei neuen Tools ist normalerweise keine Änderung am Gateway nötig, solange die fünf Bridge-Tools kompatibel bleiben.

Details: MCP – Home Assistant Bridge.

Updates prüfen

check_updates auf Host mcp-server nutzen, dann bei Bedarf install_updates.

MikroTik

Blocklist manuell prüfen

/ip/firewall/address-list/print count-only where list=blocklist
/log/print where topics~"info" and message~"blocklist"

RouterOS-Update

  1. WebFig → System → Packages → Check for Updates (Stable)
  2. verfügbares Update installieren
  3. Neustart abwarten
  4. WLAN, CAPsMAN, DNS und Internet prüfen
  5. RouterBOARD-Firmware anschließend ebenfalls prüfen/aktualisieren

DoH verify-doh-cert beobachten

/ip/dns/set verify-doh-cert=yes
/log/print where message~"DoH"
# Bei erneutem Fehler:
/ip/dns/set verify-doh-cert=no

Pool-Saison beenden

  1. input_boolean.pool_in_betrieb deaktivieren.
  2. Poolpumpe abschalten.
  3. Anlage winterfest machen.

Häufige Probleme

Problem Ursache Lösung
ebusd ERR: element not found nach Neustart noch nicht gepollt kurz warten, gezielt erneut lesen
MQTT-Entities fehlen Discovery/Filterzustand MQTT und Discovery prüfen
Disk voll auf ebusd-LXC alte Debug-Logs Logs bereinigen
MikroTik WLAN nimmt keine neuen Clients an CAPsMAN-/RouterOS-Störung Router/AP-Status prüfen, ggf. Neustart
MikroTik DNS fällt intermittierend aus DoH-TLS-Problem verify-doh-cert=no als Fallback
HA-Bridge-Tools fehlen im Client gecachter MCP-Toolkatalog MCP-Verbindung im Client aktualisieren/neu verbinden
HA-Bridge funktioniert, aber Audit fehlt Audit-Writer/Allowlist/Preload prüfen mcp-audit-writer, ha-preload.js und Bridge-Doku prüfen