diff --git a/entities/snapmaker-u1.md b/entities/snapmaker-u1.md new file mode 100644 index 0000000..4d6ea48 --- /dev/null +++ b/entities/snapmaker-u1.md @@ -0,0 +1,68 @@ +# Snapmaker U1 (3D-Drucker) + +**Modell:** Snapmaker U1 (4-Toolhead, Klipper/Moonraker) · **Netz:** 10.0.40.98 (WLAN, VLAN 40) +**Stand:** 2026-11-20 — Kamera in Home Assistant eingebunden + +## Zugänge +- **Web-UI (Fluidd):** `http://10.0.40.98` (nginx) +- **Moonraker-API:** `http://10.0.40.98:7125` — **kein Token nötig**: `[authorization] trusted_clients` enthält `10.0.0.0/8` +- **moonraker.conf:** lesbar über `GET /server/files/config/moonraker.conf` (kein `[webcam]`-Block — Webcam liegt in der Moonraker-DB, `source: database`) +- **Stock-Firmware:** kein SSH. Erweiterte Firmware (paxx12, WebRTC/SSH) existiert, ist aber **nicht** installiert (Firmware-Eingriff nur mit Owner-GO). + +## Kamera — Verhalten (wichtig) +- Einziges funktionierendes Bild: **`GET /server/files/camera/monitor.jpg`** (1920×1080 JPEG, ~80 KB, ~3 fps) +- `/webcam/?action=stream` und `?action=snapshot` → **502** (kein mjpegstreamer auf dem Printer; die Moonraker-Webcam `cam` zeigt deshalb auf tote URLs) +- **Die Kamera schläft ein**: ohne aktives Monitoring bleibt `monitor.jpg` eingefroren (mtime steht). Aufwecken nur per Moonraker-WebSocket: + `{"jsonrpc":"2.0","method":"camera.start_monitor","params":{"domain":"lan","interval":0}}` — alle ~5 s wiederholen, sonst fällt sie nach kurzer Zeit zurück. +- Antwort-Notify: `notify_camera_status_change {monitoring: true|false}` + +## Bridge auf hermes-agent-01 (10.0.30.230) +- **Datei:** `/home/debian/scripts/snapmaker_u1_cam.py` · **Service:** `snapmaker-u1-cam.service` (systemd, `enabled`, `Restart=always`) +- **Zweck:** hält die WS-Keepalive-Verbindung (5 s) und liest `monitor.jpg` mit 3 fps, solange ein Client schaut (sonst 1 Frame / 5 s); re-served als MJPEG + Snapshot. +- **Endpoints** (Port 8099, unauthentifiziert, nur VLAN 30/40): + - `GET /stream.mjpg` — multipart MJPEG, ~2–3 fps + - `GET /snapshot.jpg` — JPEG on demand (`X-Frame-Age`-Header) + - `GET /health` — JSON: `ok`, `frame_age_s`, `frames_received`, `stream_clients`, `ws_connected`, `last_error` +- Logs: `journalctl -u snapmaker-u1-cam.service -f` + +## Home Assistant +- **Integration:** MJPEG IP Camera (Core), Entry-Titel „Snapmaker U1" + `mjpeg_url=http://10.0.30.230:8099/stream.mjpg`, `still_image_url=http://10.0.30.230:8099/snapshot.jpg` +- **Entity:** `camera.snapmaker_u1` (State `idle` = normal für MJPEG; Live-View über `camera_proxy_stream`) +- **Dashboard:** View **3D-Drucker** (`/dashboard-haus/drucker`) in `dashboard_haus` — Live-Kamera, Fortschritt/Düse/Bett-Gauges, ETA/Datei/Speed/Filament, Pause/Weiter/Abbruch/Licht. Backup: `lovelace.dashboard_haus.hermesbak-20261120` +- **iOS Live Activity:** Automation `snapmaker_u1_live_activity` — Tag `snapmaker_u1_print`, 5-%-Schritte, Tap öffnet `/dashboard-haus/drucker`, `progress_bar_direction: increasing`, `relevance_score: 1.0` beim Drucken; Completion bleibt, Abbruch cleart. +- **Watchdog:** Hermes-Cron `c97b168a5230` (`check_snapmaker_cam_health.sh`, `*/10 * * * *`, no_agent) — still bei gesund; Alarm nach 15 min (Push an `mobile_app_iphone_dominik`), aber **kein Alarm, wenn der Drucker aus ist** (TCP :7125 unerreichbar ≠ Bridge-Fehler). State: `~/.local/state/snapmaker-cam/watchdog.state` +- **Deaktiviert** (Registry `disabled_by: user`, jederzeit in der UI reaktivierbar): + - `camera.snapmaker_u1_cam` — Moonraker-Webcam `cam` (502, tote mjpegstreamer-URLs) + - `camera.snapmaker_u1_webcam` — Ghost der alten hardcoded Webcam (`restored`, unavailable) +- `camera.snapmaker_u1_thumbnail` bleibt (GCode-Vorschau der Moonraker-Integration) + +## Verifikation +```bash +curl -s http://10.0.30.230:8099/health # ok:true, frame_age_s < 5 +curl -s -o /tmp/a.jpg http://10.0.30.230:8099/snapshot.jpg && file /tmp/a.jpg +# HA-Sicht: +curl -s -H "Authorization: Bearer $HA_TOKEN" \ + http://10.0.30.10:8123/api/camera_proxy/camera.snapmaker_u1 -o /tmp/ha.jpg +``` + +## Pitfalls +- **HA-Camera-Proxy cached Stills** (~10 s) — zwei `camera_proxy`-Aufrufe kurz hintereinander liefern dasselbe Bild, obwohl die Bridge live ist. Live-Nachweis über `/health` + direkte Relay-Snapshots. +- `monitor.jpg`-mtime ist der einzige Staleness-Indikator (Datei wird bei aktivem Monitor fortlaufend neu geschrieben); nach einem Bridge-Restart kann sie kurz 5–10 s alt sein → `STALE_AFTER=10 s`. +- Der Printer hängt im WLAN (wlan0) — 3 fps × 80 KB ≈ 2 Mbit/s nur während jemand schaut; Idle-Poll ist 1 Frame/5 s. +- Kein Torrent/Cloud-Zugriff nötig; Kamera bleibt im LAN. + +## Related +- Wiki: [[systems/homeassistant]] +- Solution Doc: `~/docs/solutions/integrations/2026-11-20-snapmaker-u1-kamera-homeassistant.md` +- Skill: `smart-home-automation` → `references/snapmaker-u1-camera.md` + +## Drucker-UI (Fluidd) — Kamera +Die Fluidd-Oberfläche auf `http://10.0.40.98/` hat ein eigenes Cameras-Panel. Es liest dieMoonraker-Webcam aus der **Datenbank** (`source: database`), nicht aus `moonraker.conf`. + +- **Eintrag `cam` (aktuell):** `service: mjpegstreamer-adaptive`, `stream_url: http://10.0.30.230:8099/stream.mjpg`, + `snapshot_url: http://10.0.30.230:8099/snapshot.jpg`, `aspect_ratio: 16:9`, `target_fps: 5`, `target_fps_idle: 2` +- **Gesetzt via** `POST http://10.0.40.98:7125/server/webcams/item` (vollständiges Objekt, `uid`/`source` weglassen). Backup des Originals: `~/.hermes/cache/scratch/u1_webcam_backup.json`; Original-URLs `/webcam/?action=stream|snapshot` (502, weil kein mjpegstreamer läuft). +- **Wichtig — CORS:** Fluidd setzt `crossorigin` am ``; die Bridge muss `Access-Control-Allow-Origin: *` senden (seit 20.11. umgesetzt, inkl. OPTIONS 204). +- **Kein Fehler trotz „cam (error)":** Fluidd stoppt die Wiedergabe bei `document.hidden` und leert `src`; das leere `src` lädt die Seiten-URL → `error`. Sobald der Tab sichtbar ist, Status `connected`, `naturalWidth 1920`. +- **Last:** Fluidd pollt `snapshot.jpg` mit `target_fps` (5/s) — die Bridge liefert ~3 fps; `target_fps_idle: 2` wenn das Fenster den Fokus verliert. diff --git a/index.md b/index.md index 2b558ab..b8a161a 100644 --- a/index.md +++ b/index.md @@ -16,6 +16,7 @@ ## Entities - [[entities/samsung-qn90a]] — Wohnzimmer-TV, gerootet, Vetro v0.3.5, Privacy-Stack (11/2026) +- [[entities/snapmaker-u1]] — 3D-Drucker 10.0.40.98, Moonraker 7125, Kamera-Bridge hermes-agent-01:8099 → `camera.snapmaker_u1` (11/2026) - [[entities/infrastructure]] — Physikalische Hardware, Cluster-Übersicht - [[entities/team-structure]] — CEO + Agents Modell (Nutzerprofil Dominik integriert) - [[entities/finanzen-immobilien]] — Baufinanzierung, Tegernheim, Mintos (aus L0 ausgelagert 10/2026) @@ -55,6 +56,8 @@ - [[systems/jellyfin]] — Media-Server 12.2, VIP .209:8096, ns sabnzbd, RO-Media-Mount, 12.2-API-Fallen (Auth-Header, Startup-User, Task-Routen) - [[systems/agent-fleet]] — Multi-Agent-Plattform: Bifrost-LLM-Ingress VIP .210:8080 (vllm/release-only-Policy), CNPG, Beacon v0, Phase-0-Plan (10/2026) - [[systems/technitium-dns]] — LAN-Resolver + Adblock: CT150/CT153 Cluster, VIP .149 (keepalived), DHCP-DNS via Omada (11/2026) +- [[systems/influxdb]] — drei Instanzen: hot .109 (90 d), Archiv .110 (5 y), K8s .204 leer; HA schreibt .109 (11/2026) +- [[systems/hauswacht]] — read-only Haus-/Fundament-Analyst als Hermes-Profil, Weltmodell+Journal+Wächter-Entwurf (11/2026) ## Concepts - [[concepts/network-architecture]] — 10.0.X.Y Schema, VLANs diff --git a/log.md b/log.md index 1c5fa84..a5724a6 100644 --- a/log.md +++ b/log.md @@ -1,5 +1,11 @@ # Memory Log +## [2026-11-20] Schlafzimmerlicht | Retained MQTT-Command + HA-Restart-Loop als Ursache +- **Symptom:** Licht ging „ohne Grund" an, 9× zwischen 10:00–11:00 lokal; Bulbs immer Brightness 147. +- **RCA:** `light.schlafzimmer` Discovery mit `retain: true` → HA publizierte `{"state":"ON","brightness":59}` retained auf `schlafzimmer/dimmer/set`; Automation `sz_dimmer_cmd` replayte das bei jedem HA-Start. Verstärkt durch HA-Restart-Loop (Supervisor killte Core 9×, weil `freeathome`/`alexa_devices`/`ld2410_ble` den Start blockierten). +- **Fix:** Retained Command gelöscht (`schlafzimmer/dimmer/set` leer retained) + Discovery `retain:false`; Verifikation: Start 11:10 ohne Lampen-Kommandos. HA stabil seit 11:10 (Restarts 09:58–11:10). +- **Doku:** `docs/solutions/bug-fixes/2026-11-20-schlafzimmerlicht-retained-mqtt-restart-replay.md`; Wiki `systems/homeassistant.md` gepatcht. + ## [2026-11-19] recipe-scraper-cron | 6. Crash-Tag (06:00-Fenster), Retry sofort OK, weiter No-Op bei 200k - **Lauf 1 (06:00:28):** Crash in `db_count()` — pymysql 2013, read_timeout 60 s überschritten. 2. Rezidiv nach der 4-Tage-Lücke; 6. Crash-Tag insgesamt (11-10/11/12/13/18/19). - **Lauf 2 (06:02:07):** Exit 0 — COUNT instant (<1 s), „Already at 200000 recipes". Retry-Regel (nach DB-Timeout 1× retryen) erneut bestätigt. @@ -1227,3 +1233,56 @@ - Prüffälle gerendert: Morgen frontal → BESCHATTEN, 11:47-Streiflicht → offen, 13:56 frontal → BESCHATTEN, Regen/Dämmerung → offen. - **Pitfall:** `input_number.reload` übernimmt geänderte `min`/`max` NICHT → Core-Restart nötig. - **Incident:** Nach den Core-Restarts free@home `setup_error`, alle Cover `unavailable` (~35 min). SysAP selbst wedged (`/sysap` 15–49 s, `/configuration` Timeout, Web-UI 000). Recovery: `rescue.py reboot` (reboot(0)) → SysAP ~4 min weg → `docker restart homeassistant` → Entry nach **4 min 20 s** `loaded`, alle Cover wieder da. `rescue.py probe` GETALL_TIMEOUT ist KEIN Health-Oracle. + +### 20.11.2026 — Snapmaker U1: Kamera in HA (Moonraker-Snapshot → MJPEG-Bridge) +- **Befund:** Moonraker-Integration lieferte `camera.snapmaker_u1_cam` = 502 (`/webcam/?action=snapshot`, kein mjpegstreamer auf dem Printer); `camera.snapmaker_u1_webcam` war ein `restored`-Ghost. Einzig frisches Bild: `/server/files/camera/monitor.jpg` — aber nur, solange `camera.start_monitor` per WebSocket gepulst wird, sonst steht die Datei (mtime eingefroren). +- **Umgesetzt:** `snapmaker_u1_cam.py` + systemd `snapmaker-u1-cam.service` auf hermes-agent-01 (10.0.30.230:8099): WS-Keepalive 5 s, 3 fps Pull bei Zuschauer (Idle 1 Frame/5 s), Re-Serve als `/stream.mjpg` + `/snapshot.jpg` + `/health`. HA: MJPEG-IP-Camera „Snapmaker U1" → `camera.snapmaker_u1`; die zwei toten Moonraker-Cam-Entities per Registry deaktiviert. +- **Verifiziert:** `/health` frame_age < 2 s, 10 MJPEG-Frames in 4 s über HA `camera_proxy_stream`, HA-Stills 1920×1080, Service `enabled`+`active`, `Restart=always`. +- **Gelernt:** HA-Camera-Proxy cached Stills (~10 s) → zwei kurze `camera_proxy`-Calls beweisen keine Live-Bildfolge; Snapshot-only-Kameras brauchen eine Bridge, wenn die Quelle ~3 fps liefert. Printer-Moonraker hat `trusted_clients 10.0.0.0/8` → kein Token für WS/API. +- Wiki: `entities/snapmaker-u1.md` · Doc: `docs/solutions/integrations/2026-11-20-snapmaker-u1-kamera-homeassistant.md` + +### Nachtrag 20.11. 07:35 UTC — Snapmaker: Dashboard-View, Watchdog, Live-Activity-Tap +- **Dashboard:** neue View `3D-Drucker` (`/dashboard-haus/drucker`) in `dashboard_haus` via `lovelace/config/save` — Camera live, 3 Gauges (Fortschritt/Düse/Bett), Entities (Datei/ETA/Speed/Kammer/Filament), Pause/Weiter/Abbruch/Licht (Mushroom). 17 Entities vorab gegen `/api/states` geprüft; Backup `lovelace.dashboard_haus.hermesbak-20261120`. +- **Watchdog:** Cron `c97b168a5230` (`check_snapmaker_cam_health.sh`, `*/10`, no_agent, deliver local) + Push an `mobile_app_iphone_dominik`. 15-min-Grace, ein Alarm pro Ausfall, Erholungszeile. **Drucker aus ≠ Alarm** (TCP :7125 als Diskriminator). Getestet: healthy still, bridge-down Alarm+Dedupe+Recovery, stale+Printer-aus still, stale+Printer-an Alarm; Notify-Kanal 200. +- **Live Activity:** `snapmaker_u1_live_activity` um `url: /dashboard-haus/drucker` (Tap), `progress_bar_direction: increasing`, `relevance_score: 1.0` (printing) erweitert; Config-Roundtrip via REST `POST /api/config/automation/config/` (4 live_update-Blöcke gepatcht, Readback ok). +- **Pitfall:** `automation.trigger` mit `mode: restart` wird von jedem echten Progress-Trigger sofort überschrieben → kein Trace; Live-Activity-Sends passieren am **Band-Ende** (letzter 5-%-Block), nicht am Band-Anfang. + +### Nachtrag 20.11. 08:20 UTC — Snapmaker-Kamera auch in Fluidd (Drucker-UI) +- **Webcam-Eintrag umgebogen:** Moonraker-DB-Webcam `cam` per `POST /server/webcams/item` auf die Bridge-URLs (`mjpegstreamer-adaptive`, `http://10.0.30.230:8099/stream.mjpg|snapshot.jpg`, 16:9, fps 5/2). Original-Backup `u1_webcam_backup.json` (alte URLs `/webcam/?action=…` → 502). +- **CORS war der Blocker:** Fluidd rendert ``; ohne `Access-Control-Allow-Origin` → sofort `error`. Bridge liefert jetzt ACAO `*` (+ OPTIONS 204) auf Stream/Snapshot/Health; Service restartet. +- **Scheinfehler „cam (error)":** Fluidd stoppt Playback bei verstecktem Tab und leert `src` → leeres src lädt die Seiten-URL → error-Event. Bei sichtbarem Tab: `connected`, 1920×1080, Snapshot-Polling 5 fps. +- **Verifiziert:** DOM `img.camera-image` src=`…/snapshot.jpg?cacheBust=…`, naturalWidth 1920, Status `connected`; Screenshot `fluidd_kamera.png`. + +### 20.11.2026 — Hauswacht: read-only Haus-/Fundament-Analyst als Hermes-Profil + +- **Anlass:** Kollegen-Persona „Hauswacht" (OpenClaw, InfluxDB-Weltmodell) auf unsere Umgebung adaptiert. +- **Ergebnis:** 5. Hermes-Profil `hauswacht` mit SOUL/MANDAT + Weltmodell (`WELTMODELL`, `BEWOHNER-RAEUME`, `ZUGRIFF`, `KENNTNIS`), Journal und Vorschlagsliste. Domäne: Haus **und** Fundament inkl. „Naht" (HA-Aussetzer ↔ Ceph/Galera) — kein InfluxDB, Quellen sind HA-REST, Prometheus, Loki, `pvesh`, `ceph`. +- **Sicherheit:** strikt read-only (keine HA-Service-Calls, kein `qm`/`pct`/`kubectl`-Write); Wächter-Lebenszyklus mit ≥7 Tagen Schattenlauf vor Owner-GO. Nichts scharf: kein Cron, `watchers/aktiv/` leer, Gateway-Dienst nicht installiert. +- **Verifiziert:** `stille_kanaele.py --selftest` OK, scharfer Lauf `NO_REPLY`; Oneshot-Chat lud Persona + beantwortete `count(up==0)` korrekt (0 down). +- **Pitfall:** Neues Profil bleibt `profile_parked`, weil der Host-Gateway standalone ist → `gateway.standalone: true` im Profil + eigener Dienst (oder `gateway migrate --multiplex`). +- Wiki: `systems/hauswacht.md` · Doc: `docs/solutions/bug-fixes/2026-11-20-hermes-neues-profil-profile-parked.md` + +### 20.11.2026 — InfluxDB-Korrektur: drei Instanzen, HA schreibt auf die hot-Instanz, Archivkette unbewacht + +- **Anlass:** Owner-Widerspruch („Es gibt influx. Siehe home assistant") gegen meine Behauptung „kein InfluxDB". Zwei Port-Proben (`.10`, `.230`) waren kein Beweis; `.109` fehlte in der ip-map. +- **Befund:** **Drei Instanzen, zwei Rollen.** HOT `10.0.30.109` (LXC 109 proxmox6, v2.7.11): `ha_hot_90d`, **90 Tage** (ältester Punkt 22.08.2026), ~1.817 Entities/30 d, **HA schreibt hierher**. ARCHIV `10.0.30.110` (LXC 134 `influxdb-archive`): `ha_archive_5y_5m`, **5 Jahre**, 5-Min-Mittel, gefüllt seit **28.04.2026** (pv_production 17.317 Punkte, 50 MB). K8s `10.0.30.204` (v2.7.12): Buckets vorhanden, **0 Datenpunkte**, 18 identische Tasks lesen den lokalen leeren Hot-Bucket — unfertige Migration. +- **Fluss:** Task auf `.109`, stündlich, `range(-91d,-90d)` → `aggregateWindow(5m,mean)` → `to(host: .110)`; Archiv-Token steht im Task-Flux. +- **Falle:** `configuration.yaml` zeigt auf `.204`, aber seit HA **2026.9** sind Verbindungs-Keys dort wirkungslos; aktiv ist der UI-Config-Entry (`source: import`) auf `.109`. +- **Offener Fund (V-006):** Die Archivkette ist **unbewacht** — kein Prometheus-Job, kein Watchdog, kein Cron. Fenster genau 1 Tag breit → Ausfall >24 h verliert den Tag endgültig. +- **Nachtrag (verschärft):** Die Kette ist **bereits gerissen**. Hot 23.08.–20.11. (79 Tage), Archiv 06.05.–23.08. (91 Tage) → **78 Tage fehlen**. Der Task meldet stündlich `success`, weil er an der Retention-Kante liest und `to()` mit null Zeilen kein Fehler ist. Backfill-Plan (`scripts/backfill_archiv.py --plan`): 78 Tage, 2,42 Mio. PV-Punkte; nichts geschrieben. +- Wiki: `systems/influxdb.md` (neu), `systems/hauswacht.md`, `reference/ip-map.md`, `reference/ports.md` · Doc: `docs/solutions/bug-fixes/2026-11-20-influxdb-drei-instanzen-yaml-luegt.md` + +### 20.11.2026 — V-006 umgesetzt: Archiv-Task gefixt, Backfill läuft, Wächter-Entwurf + +- **Owner-GO „1"** für Backfill + Task-Fix + Wächter. +- **Task `.109` repariert:** `every 24h/-4d..-1d` scheiterte am Remote-Timeout von `to()` → jetzt **`every 6h`, `range(-2d,-1d)`** (1 Tagesfenster, 4 idempotente Chancen/Tag). Neuer Task läuft; ein manueller Testlauf während des Backfills lief in den Timeout (Konkurrenz), wird nach Backfill erneut geprüft. +- **Backfill läuft:** 24.08.–20.11., Tag für Tag, 5-Min-Mittel; Fortschritt im Log `/tmp/backfill_archiv.log`, Archiv 50→61 MB nach 13 Tagen. Probe 24.08. verifiziert (168 Punkte, Mittagswert 10.888 W vs. Hot ~12.089 W). +- **Neuer Fund:** Hot hat eine echte **11-Tage-Lücke 23.09.–03.10.2026** (auch dort keine Daten) — Aufzeichnungslücke, nicht rekonstruierbar. +- **Wächter-Entwurf** `archiv_luecke.py`: jüngster Archiv-Punkt < 30 h, ≥ 6 von 7 Tagen mit Daten, Task aktiv+frisch; `--selftest` grün (3 Meldungen im Fehlerfall), nicht scharf. + +### 20.11.2026 — V-006 abgeschlossen: Archiv 168 Tage, Task bewiesen, Wächter grün + +- **Backfill fertig:** 79 Tage geschrieben (76 Hauptlauf + 25./26.08. + 03.10., an denen nur andere Entities Daten hatten), **0 Fehler**. Archiv 91 → **168 Tage** (05.05.–20.11.), 50 → ~105 MB. Nur 23.08. bleibt als Grenztag außen vor (Archiv hat dort bereits Daten). +- **Task verifiziert:** manueller Lauf 13:00 `success`, **70.472 Punkte** im Fenster geschrieben — Beweis über Daten, nicht über Status. +- **Wächter:** echter Lauf `NO_REPLY` (jüngster Punkt 0 h, 8 Tage, Task frisch); `--selftest` grün. Schattenlauf läuft, `aktiv/` bleibt leer. +- **Korrigierter Befund:** Aufzeichnungslücke in Hot ist **22.09.–02.10.2026** (nicht 23.09.–03.10.) — `aggregateWindow` labelt mit dem Fenster-ENDE; ohne `timeSrc:"_start"` war jede Tageszählung um eins verschoben (hätte Fehlalarm erzeugt). diff --git a/patterns/skill-impact.md b/patterns/skill-impact.md index a8b2216..b54b380 100644 --- a/patterns/skill-impact.md +++ b/patterns/skill-impact.md @@ -50,3 +50,4 @@ The entry records WHAT changed, WHY, and WHETHER it helped (if validated). | 2026-11-15 | devops/network-reconnaissance | patched | Pitfall ergänzt: zip(ips, as_completed(futures)) misattribuiert Alive-IPs (77/91 Ghosts im Weekly-Scan); Korrektur: pool.map oder {fut: ip}-Dict; Cross-Check gegen ip-map | tested | accepted | docs/solutions/bug-fixes/2026-11-15-network-scan-ip-attribution-bug.md | | 2026-11-15 | openscad-functional-parts | patched | Pitfalls +2: (1) OpenSCAD 2021.01 CLI-Quirks — kein `--render`, `-o` relativ zur .scad-Datei, STL default ASCII (`--export-format binstl`), `color()` im PNG-Export ignoriert, Framing via `--viewall --autocenter`; (2) Regel «Passungskonus in fester Außenkontur ⇒ Wand geht gegen 0», Wand an beiden Enden rechnen | tested | accepted | docs/solutions/workflows/2026-11-15-konus-passung-wandstaerke-vorab-pruefen.md | | 2026-11-15 | devops/proxmox-ve-administration | patched | Ref `openstack-offsite-pbs-2026-07.md`: Abschnitt "Kapazität vergrößern" ergänzt — `openstack volume set --size` (kein `volume extend` in OSC 10.1), Mikroversion ≥3.42 für in-use, rescan+resize2fs+tune2fs -m 1, ENOSPC-Trugschluss bei vollem Dedup-Store | tested | accepted | docs/solutions/bug-fixes/2026-11-15-offsite-pbs-volume-extend.md | +| 2026-11-20 | devops/hermes-profile-setup | patched | Step 0 „Gateway-Topologie prüfen" ergänzt: `profile create` legt keinen Gateway an → `profile_parked`; Fix `gateway.standalone: true` + eigener Dienst (oder `gateway migrate --multiplex`), webhook/api_server-Ports vorher abschalten. Pitfall-Zeile ergänzt. | tested | accepted | docs/solutions/bug-fixes/2026-11-20-hermes-neues-profil-profile-parked.md | diff --git a/reference/ip-map.md b/reference/ip-map.md index b5f6403..863e927 100644 --- a/reference/ip-map.md +++ b/reference/ip-map.md @@ -65,7 +65,9 @@ modified: "2026-09-30" | 10.0.30.201 | Grafana | monitoring | 3000 | | 10.0.30.202 | Prometheus | monitoring | 9090 | | 10.0.30.203 | Traefik (K8s Ingress) | kube-system | 80/443 | -| 10.0.30.204 | InfluxDB | influxdb | 8086 | +| 10.0.30.204 | InfluxDB (K8s, **leer** — Migration unfertig) | influxdb | 8086 | +| 10.0.30.109 | InfluxDB **hot** (HA schreibt, 90 d) | LXC 109 auf proxmox6 | 8086 | +| 10.0.30.110 | InfluxDB **Archiv** (5 y, 5-Min) | LXC 134 auf proxmox6 | 8086 | | 10.0.30.205 | PostgreSQL (CNPG rw LB) | postgres | 5432 | | 10.0.30.206 | SABnzbd (Web+SMB) | sabnzbd | 8080/445 | | 10.0.30.207 | Loki Gateway | loki | 3100 | diff --git a/reference/ports.md b/reference/ports.md index 53294e8..ba026de 100644 --- a/reference/ports.md +++ b/reference/ports.md @@ -18,7 +18,9 @@ modified: "2026-07-24" | 3306 | MariaDB (MaxScale VIP) | 10.0.30.70 | Galera HA | | 5432 | PostgreSQL (CNPG) | postgres-main-rw.postgres.svc | K8s internal | | 8000 | Paperless-ngx | paperless.svc | K8s internal | -| 8086 | InfluxDB | 10.0.30.204 | LB | +| 8086 | InfluxDB **hot** (HA schreibt) | 10.0.30.109 | LXC 109 proxmox6, 90 d | +| 8086 | InfluxDB **Archiv** | 10.0.30.110 | LXC 134 proxmox6, 5 y, 5-Min-Mittel | +| 8086 | InfluxDB K8s (**leer**) | 10.0.30.204 | LB, unfertige Migration | | 8989 | MaxScale Admin | 10.0.30.81 | admin:mariadb | | 9090 | Prometheus | 10.0.30.202 | LB `monitoring-kube-prometheus-prometheus` (10.10. live verifiziert; ~~.206~~ stale) | | 9093 | Alertmanager | K8s internal | | diff --git a/systems/hauswacht.md b/systems/hauswacht.md new file mode 100644 index 0000000..a60eea0 --- /dev/null +++ b/systems/hauswacht.md @@ -0,0 +1,58 @@ +--- +title: "Hauswacht — read-only Haus- & Fundament-Analyst (Hermes-Profil)" +category: systems +tags: [hermes, profile, hauswacht, observability, homeassistant, persona] +created: "2026-11-20" +modified: "2026-11-20" +--- + +# Hauswacht + +Read-only Analyst für **Haus und Fundament**: versteht Zusammenhänge statt Schwellen zu melden, führt ein eigenes Weltmodell/Journal und baut sich billige Wächter — die erst nach Owner-GO scharf werden. Adaption eines OpenClaw-Persona-Pakets eines Kollegen (SOUL/AGENTS/IDENTITY/USER) auf unsere Umgebung. + +## Ort & Zustand + +| Punkt | Wert | +|---|---| +| Profil | `/home/debian/.hermes/profiles/hauswacht/` (5. Profil auf hermes-agent-01) | +| Identität | `SOUL.md` (wird je Session geladen) + `MANDAT.md` (Arbeitsregeln) | +| Weltmodell | `workspace/WELTMODELL.md`, `BEWOHNER-RAEUME.md`, `ZUGRIFF.md`, `KENNTNIS.md` | +| Gedächtnis | `workspace/JOURNAL.md`, `VORSCHLAEGE.md` | +| Wächter | `workspace/watchers/entwurf/stille_kanaele.py` — **Entwurf**, kein Cron, `aktiv/` leer | +| Gateway | `gateway.standalone: true` in config.yaml; Dienst **nicht installiert** → Profil derzeit gestoppt | +| Modell | `vllm/release/glm-5-3-flash`, Fallback `deepseek-v41-flash` / `qwen3.8-27b` | + +## Datenquellen (bewusst anders als die Vorlage) + +Die Vorlage las InfluxDB (z2m → NodeRed → Influx). **Bei uns gibt es InfluxDB — aber dreifach:** hot `.109` (90 d, HA schreibt hierher), Archiv `.110` (5 Jahre, 5-Min-Mittel), K8s `.204` (**leer**, unfertige Migration). Das Weltmodell wurde auf die echten Pfade übersetzt: + +- **Haus:** Home Assistant `10.0.30.10:8123` (2.819 Entities; Recorder SQLite), MQTT/Zigbee2MQTT, free@home über XMPP, ESPHome, Shelly, ViCare-Cloud. **Historie:** InfluxDB `.109` (90 d) + Archiv `.110` (5 y, 5-Min). +- **Fundament:** Prometheus `10.0.30.202:9090` (103 Targets), Loki `10.0.30.207:3100` (`job=fluent-bit*`), PVE via `pvesh get`, Ceph via `ceph status --format json` (MON/MGR `10.0.20.92`). + +## Kern der Adaption + +1. **Die Naht ist das Revier:** Haus und Cluster sind ein Körper — am 08.11. fror HA ein, weil Galera-SST/Ceph-slow-ops im Keller liefen. Diese Kopplung überwacht sonst niemand (infra-sre = Security/SLA, Prometheus = Schwellen). +2. **Read-only ist absolut:** keine HA-Service-Calls, kein `qm`/`pct`/`kubectl`-Write, kein `systemctl`; Schreiben nur im Profil-Workspace. Anders als infra-sre hat Hauswacht **keine** Aktionsrechte, auch nicht mit Freigabe. +3. **Wächter-Lebenszyklus mit Schattenlauf:** Entwurf → ≥7 Tage Dry-Run (nur Log) → Owner-GO → aktiv (silent-on-healthy, `NO_REPLY`) → Rückbau bei Bedeutungslosigkeit. Grund: Heuristik-Veto des Owners. +4. **Kein Alert-Manager:** baut keine Schwellen-Wächter, die Prometheus/Alertmanager bereits abdecken. + +## Verifikation (20.11.2026) + +- `stille_kanaele.py --selftest` → SELFTEST OK (Treffer-Pfad für „still" + „unavailable"). +- Scharfer Lauf → `NO_REPLY` (alle 7 curierten Kanäle frisch). +- Oneshot-Chat: Persona lud SOUL/MANDAT/KENNTNIS und beantwortete `count(up==0)` korrekt mit 0 (inkl. Gegenprobe auf leeren Vektor). + +## Aktivieren + +```bash +hauswacht gateway install # systemd-Dienst (nötig, sonst profile_parked) +hauswacht chat # Chat +``` + +Berichte/Vorschläge: `workspace/reports/`, `workspace/VORSCHLAEGE.md`. Kein Telegram, kein Push, kein Cron. + +## Related + +- [[systems/homeassistant]] · [[systems/monitoring]] · [[systems/proxmox-cluster]] · [[systems/ceph-cluster]] +- Solution: `docs/solutions/bug-fixes/2026-11-20-hermes-neues-profil-profile-parked.md` +- Skill: `devops/hermes-profile-setup` diff --git a/systems/heizung-viessmann.md b/systems/heizung-viessmann.md index e48445a..b56c789 100644 --- a/systems/heizung-viessmann.md +++ b/systems/heizung-viessmann.md @@ -45,9 +45,26 @@ Windfang hingen dadurch dauerhaft auf 100 % Ventilhub. | `automation.morgen_profil_an_04_30` (1763220000010) | on (neu) | **04:30** Morgen-Profil: Bad **28,0** · Wohnen/Essen 23,0 · Flure 22,0 · WC 22,5 | | `automation.morgen_profil_aus_07_00` (1763220000011) | on (neu) | **07:00** zurück auf Basis (Bad **26,0** Dauerheizen · Wohnen/Essen 22,5 · Flure 21,0 · WC 22,0) | -**Wichtig:** HA kann Automations per `POST /api/config/automation/config/{id}` anlegen und -per `DELETE` löschen (verifiziert 15.11.2026, HA 2026.10.4) — die verbreitete Annahme -„geht nur per YAML" stimmt nicht. +**Wichtig (korrigiert 20.11.2026):** `POST /api/config/automation/config/{id}` legt die +Automation nur **flüchtig** an — nach dem nächsten HA-Neustart sind Entität und Config weg +(`unavailable` + 404). Am 20.11. 09:59 sind so alle fünf per API erzeugten Automationen +verschwunden, inkl. der WW-Peak-Blockade (WW-Soll blieb dadurch zwei Tage auf 44 °C). +Dauerhaft nur über die UI, YAML oder einen Hermes-Cronjob. + +## WW-Preislogik (Cronjob, dauerhaft) + +`hermes cron` Job **85b678fdd885** „WW-Preislogik (Viessmann)", `no_agent`, Cron +`4,19,34,49 * * * *` (alle 15 min), Script `~/.hermes/scripts/ww_preislogik.py`. +Läuft außerhalb von HA und übersteht HA-Neustarts (die per API angelegten HA-Automationen +tun das nicht, siehe oben). + +Regeln: „teuer" = EPEX-Preis > Tagesmedian + 1,5 ct → WW-Soll auf **44 °C**; „billig" = +< Median + 0,5 ct (Hysterese) → **vorheriger Wert** wird exakt zurückgeschrieben (kein +hartkodierter Normalwert). Guards: keine Blockade während einer laufenden WW-Ladung, +Freigabe bei Speicher < 41 °C, **Failsafe 8 h** maximale Blockade. +Zustand: `~/.hermes/state/ww_preislogik.json`. Token: `~/.hermes/secrets/ha_token` (0600, +`op`-Fallback), LAN-Fallback auf 10.0.30.10:8123 wenn Traefik 502 liefert. +Ausgabe nur bei Fehlern (verifiziert: Lauf 20.11. 10:31 → „silent (empty output)"). ## Preisbild / Lastverschiebung diff --git a/systems/homeassistant.md b/systems/homeassistant.md index 660052e..200a8b3 100644 --- a/systems/homeassistant.md +++ b/systems/homeassistant.md @@ -29,6 +29,12 @@ modified: "2026-11-01" - **ACL:** `/etc/mosquitto/acl` definiert `user homeassistant` + `user addons` - **Auth Plugin:** `go-auth.so` (files,http backends) +## MQTT Retained-Command-Falle (20.11.2026) +- **Symptom:** Schlafzimmerlicht (5 TRADFRI + free@home-Template) ging „ohne Grund" an, gehäuft bei HA-Neustarts. +- **Ursache:** Discovery von `light.schlafzimmer` (`schlafzimmer_dimmer_v3`) hatte `retain: true` → HA publizierte jedes Kommando retained auf `schlafzimmer/dimmer/set`; Automation `sz_dimmer_cmd` lauscht auf diesem Topic und replayte beim jedem HA-Start/MQTT-Reconnect `{"state":"ON","brightness":59}` → `sz_dimmer_apply` → Bulbs an (immer Brightness 147). 20.11.: 9 Restarts 09:58–11:10 lokal (Supervisor killte Core, weil `freeathome`, `alexa_devices`, `ld2410_ble` den Start blockierten: „Waiting for integrations to complete setup") → 9 Einschaltungen. +- **Fix:** Retained Command mit leerem retained Payload gelöscht + Discovery mit `"retain": false` neu publiziert (State-Persistenz bleibt, weil `sz_dimmer_apply` den State-Topic selbst retained publiziert). Verifikation: Start 11:10 erzeugte keine `zigbee2mqtt/schlafzimmer_lampe_*/set`-Kommandos mehr. +- **Regel:** Retained nie auf Command-Topics, die eine lokale Automation konsumiert. Bei „Licht geht ohne Grund an" zuerst Event-Zeiten gegen `homeassistant/status offline` / Supervisor-Restarts korrelieren. Details: `docs/solutions/bug-fixes/2026-11-20-schlafzimmerlicht-retained-mqtt-restart-replay.md` + ## Automations - **File:** `/config/automations.yaml` (35 Automations) - **Schreibmethode:** SSH → `docker exec homeassistant chmod 666`, danach restore 644 @@ -86,6 +92,7 @@ modified: "2026-11-01" ## Entitäten - Kameras: `camera.einfahrt_2`, `camera.terrasse_2` (Suffix `_2` wegen verwaister Integration) +- 3D-Drucker: `camera.snapmaker_u1` (MJPEG via Bridge 10.0.30.230:8099 — siehe [[entities/snapmaker-u1]]) - Motion: `binary_sensor.einfahrt_motion_2`, `binary_sensor.terrasse_motion_2` - Input Text: `input_text.frigate_last_event_id` (dedup storage, max 255 chars) @@ -210,13 +217,16 @@ Aggregation: `sensor.pv_production` = min_max über 5 Sensoren (2×SMA grid_powe - ✅ **Sauna-Shelly misst NETTO** (HM-1500 speist auf dem Sauna-Stromkreis rück): Shelly = Kreislast − Zelt-PV (validiert 11.10.: Steigung −0.983, r=−0.9985; Integrale 2,07 vs. 2,13 kWh). Template `Sauna Active Power` GEFIXT 19:39: `max(0, ΣPhasen + hm_1500_power)` mit float(0)-Guards — liefert jederzeit die wahre Sauna-Last, "Rest"-Helfer korrekt. - Solution Doc: `docs/solutions/integrations/2026-10-11-solcast-sample-site-contamination-and-tz-shift.md` -## Garagentor (free@home ch0003) — Flanken-Toggle-Semantik -- **Kanal:** `switch.garagentor` = free@home Schaltaktor `ABB20C351F51/ch0003`, treppenlicht-parametriert (Kanal nach Aktivierung AN bis Timer-Ablauf). `cover.garagentor` = Template-Cover darüber (open/close = je EINE Kanalaktivierung). -- **Motor toggelt auf JEDE Kanalflanke.** Einzelimpuls = sauber Umschalten (belegt: 17:51 Puls → schloss in ~90s). **Zwei schnelle Flanken = Start-Stopp** (belegt: 17:07 mein OFF→ON-Doppelpuls, 17:48 Nutzer-Doppelklick — jeweils blieb das Tor offen!). Doppelklick-Gewohnheit wirkt der Schließfahrt aktiv entgegen. -- **BUG (seit 05.10.):** `switch.garagentor` = `unknown`, 0 Logbook-Events — Statusrückmeldung SysAP→HA für ch0003 tot. SysAP-REST-Zugang ist bekannt (Local-API-User `Installer`, s. Abschnitt „free@home Local-API" unten), SSH-Addon gestoppt. -- **Automations (2026-10-10, REST-config):** `warn_offen_beim_verlassen` (Person weg >2min + Garagentor/Esszimmertür offen → time-sensitive Push mit CLOSE_GARAGE-Button) + `garagentor_push_close` **v8 Single-Edge** (Guards: offen+90s stabil+45s Anti-Doppeltipp; EIN switch.turn_on, KEIN turn_off-Präludium; 45s-Verifikation per Neigungssensor; Retry erst nach 480s; ehrliche Fehler-Push). Tag `warn_offen_beim_verlassen` aktualisiert Notifications. +## Garagentor (free@home ch0003) — Trigger-Kanal (FID 0x45), Stand 20.11.2026 +- **Kanal:** `ABB20C351F51/ch0003` ist seit der Umparametrierung **kein Schaltaktor/Treppenlicht mehr**, sondern **Trigger** (`functionID 0x45` = FID_TRIGGER; `par0032=10` = PID_TRIGGER_DURATION/„Wisch-Impuls"). Inputs: `idp0001` = AL_TIMED_START_STOP (pairing 2), `idp0003` = AL_SCENE_CONTROL (pairing 4); **keine Outputs** → keine Statusrückmeldung. `idp0001` bleibt nach dem Impuls auf `1` stehen (Latch, kein Live-Signal). +- **Impuls:** EIN Schreibvorgang `1` auf `idp0001` = EIN Trigger-Impuls; der SysAP beendet ihn nach `par0032` selbst. Kein `turn_off`-Präludium, keine Haltephase. Wandtaster `ABB700C8097D/ch0001`+`ch0002` sind auf ch0003 gepairt (`/pairings`). +- **Motor bleibt Toggle:** Puls auf geschlossenes Tor → öffnet; Puls auf offenes, ruhendes Tor → schließt; zwei schnelle Pulse = Start-Stopp (Tor bleibt offen). Regel: **ein Impuls pro Fahrt.** +- **HA-Abbildung:** Das alte `switch.garagentor` ist tot (gleiche unique_id, wird für FID 0x45 nicht mehr erzeugt) → `unavailable`, in der Registry **deaktiviert**. Die Integration legt `button.garagentor_impuls` an (`button.press` schreibt `1` auf AL_TIMED_START_STOP, `custom_components/freeathome/fah/devices/fah_trigger.py`). +- **`cover.garagentor`** (Template über Neigungssensor): `open_cover` nur bei Sensor `off`, `close_cover` nur bei `on`, jeweils + letzter Impuls >100 s (Button-State = Zeitstempel); sonst `persistent_notification` mit Grund. Availability = Sensor nicht unavailable/unknown. +- **Automations:** `warn_offen_beim_verlassen` unverändert (Push mit CLOSE_GARAGE). `garagentor_push_close` **v9**: Guards (Sensor on, Cover >90 s unverändert, Impuls >100 s her) → EIN `button.press` → 120 s warten (Fahrzeit ~90 s) → Verifikation; **kein automatischer zweiter Impuls** (v8 prüfte nach 45 s und feuerte 8 min später blind — auf ein dann geschlossenes Tor = Öffnen). Der alte `garagentor_schalter_auto_aus` ist **deaktiviert** (Auto-Off war nur für den Schaltaktor nötig). +- **E2E verifiziert (20.11.2026):** 12:14:34 `cover.open_cover` → `button.garagentor_impuls` → Neigungssensor `on` nach 5,3 s (12:14:39), stabil. Negativpfad (geschlossen → Guard, kein Impuls) ebenfalls live. Einheit von `par0032` ist nicht dokumentiert. - Nur 2 physische Öffnungssensoren im Haus: Garagentor (Neigungssensor+Cover) + Esszimmertür (`binary_sensor.esszimertur_contact`, Aqara). free@home-Panels sind Taster, KEINE Fensterkontakte. -- Solution Doc: `docs/solutions/integrations/2026-10-10-freeathome-garage-impulse-toggle-semantics.md` +- Lösungshistorie: `docs/solutions/integrations/2026-10-10-freeathome-garage-impulse-toggle-semantics.md` (altes Treppenlicht-Modell, durch FID-0x45-Umbau überholt) ## free@home SysAP XMPP-Wedge & Remote-Reboot (Stand 12.10.2026) - **Chronik:** 05.10. IqTimeout-Massenausfall (22 Entities, Fix: 120s-getAll-Timeout+300s-Keepalive, ephemeral in Container). **11.10. 19:56 erneuter Totalausfall** — diesmal trotz Patch: XMPP-RPC-Dispatcher lebte (echoTest/HW 0,1s), aber `getAll` hing serverseitig (>280s, REST liefert dieselben Daten instantan). HA-Restart wirkungslos (Fehler kam direkt nach frischem HA-Start 19:53). diff --git a/systems/influxdb.md b/systems/influxdb.md new file mode 100644 index 0000000..f82289e --- /dev/null +++ b/systems/influxdb.md @@ -0,0 +1,77 @@ +--- +title: "InfluxDB — drei Instanzen, zwei Aufgaben (hot / Archiv / tote K8s-Kopie)" +category: systems +tags: [influxdb, homeassistant, historie, archive, flux, k8s] +created: "2026-11-20" +modified: "2026-11-20" +--- + +# InfluxDB + +> **Kurzfassung:** HA schreibt auf `.109` (90 Tage). Ein stündlicher Flux-Task dort schreibt das ablaufende Tagesfenster als 5-Minuten-Mittel nach `.110` (5 Jahre). Eine dritte Instanz in K8s (`.204`) ist **leer** und hat 18 tote Tasks — eine begonnene, nie verdrahtete Migration. + +## Die drei Instanzen + +| Rolle | Adresse | Wo | Version | Bucket / Retention | Zustand 20.11.2026 | +|---|---|---|---|---|---| +| **Hot** | `10.0.30.109:8086` | LXC **109** `influxdb` auf proxmox6 | v2.7.11 | `ha_hot_90d`, 90 d | **schreibend**; ältester Punkt 22.08.2026; ~1.817 Entities in 30 d | +| **Archiv** | `10.0.30.110:8086` | LXC **134** `influxdb-archive` auf proxmox6 | v2.7.11 | `ha_archive_5y_5m`, 5 Jahre | **seit 23.08.2026 gerissen**: Bestand 06.05.–23.08., **78 Tage fehlen** (24.08.–20.11.) | +| **K8s** | `10.0.30.204:8086` | NS `influxdb`, Pod `influxdb-0`, LB | v2.7.12 | `ha_hot_90d` + `ha_archive_5y_5m` | **leer** (Engine 1,1 MB); 18 identische Tasks, die den lokalen leeren Hot-Bucket lesen; tägliche Backup-CronJobs | + +Org überall `homelab` — aber **unterschiedliche Org- und Token-IDs**. Tokens sind nicht austauschbar. + +## Der Datenfluss + +``` +Home Assistant (VM106) + │ influxdb-Integration (UI-Config-Entry, source: import — NICHT die YAML) + ▼ +10.0.30.109 : ha_hot_90d (90 Tage, rohe States) + │ Flux-Task "archive_5m_to_hdd_90d", stündlich, offset 10m + │ range(start:-91d, stop:-90d) → aggregateWindow(5m, mean) → to(host: .110) + ▼ +10.0.30.110 : ha_archive_5y_5m (5 Jahre, 5-Minuten-Mittel) +``` + +Der Archiv-Token steht **im Flux-Skript** des Tasks (`GET /api/v2/tasks` auf `.109`, Feld `flux`). Er taucht in keiner YAML auf. + +## Zwei Fallen + +1. **YAML lügt.** `configuration.yaml` enthält weiterhin einen `influxdb:`-Block mit `host: 10.0.30.204`, `token: …`, `bucket: ha_hot_90d`. Seit HA **2026.9** sind die Verbindungs-Keys dort wirkungslos (nur `include`/`exclude`/`tags` bleiben); die Verbindung lebt im UI-Entry (`source: import`) und zeigt auf `.109`. Wer die Datei liest, konfiguriert das Falsche. +2. **Die Archivkette riss am 23.08.2026 — und wurde am 20.11. repariert.** Der stündliche Task lief mit `range(-91d,-90d)`, also genau an der Retention-Kante; dort war bereits gelöscht, `to()` bekam null Zeilen und meldete trotzdem `success`. Hot: 23.08.–20.11. (79 Tage), Archiv: 05.05.–23.08. (91 Tage) → **78 Tage fehlten**. + - **Fix:** Task jetzt `every: 6h`, `range(-2d,-1d)`. Ein 3-Tage-Fenster scheiterte am Remote-Timeout von `to()`; die 6-h-Kadenz gibt 4 idempotente Chancen pro Tag. Verifiziert: Lauf 20.11. 13:00 `success`, 70.472 Punkte im Fenster. + - **Backfill:** `~/.hermes/profiles/hauswacht/workspace/scripts/backfill_archiv.py` — **abgeschlossen**: 79 Tage, 0 Fehler, Archiv 91 → **168 Tage** (05.05.–20.11.), 50 → ~105 MB. + - **Echte Aufzeichnungslücke:** 22.09.–02.10.2026 fehlt **auch in Hot** (11 Tage) — nicht rekonstruierbar. 03.10. hatte nur einen Rest (386 Entities), nachgezogen. + - **Pitfall:** `aggregateWindow` labelt mit dem Fenster-**Ende**; ohne `timeSrc:"_start"` ist jede Tageszählung um eins verschoben (hätte Fehlalarm erzeugt). + - **Wächter:** `watchers/entwurf/archiv_luecke.py` — echter Lauf `NO_REPLY` (jüngster Punkt 0 h, 8 Tage, Task frisch), `--selftest` grün, **nicht scharf** (Schattenlauf). + +## Semantik (wichtig für Flux) + +- `default_measurement: units` → **Measurement = Einheit** (`"W"`, `"%"`, `"EUR/kWh"`, …). +- Entität ist **Tag** `entity_id` (plus `domain`, `friendly_name`, `source=HA`). +- Numerischer Wert: Feld **`value`**; String-Attribute als `_str`. +- Abfrage also: + ```flux + from(bucket:"ha_hot_90d") |> range(start:-24h) + |> filter(fn:(r)=> r.entity_id=="pv_production" and r._field=="value") + ``` + +## Betrieb + +```bash +# Health +curl -s http://10.0.30.109:8086/health +curl -s http://10.0.30.110:8086/health + +# Tasks (inkl. Flux + Token) +curl -s -H "Authorization: Token $TK" http://10.0.30.109:8086/api/v2/tasks + +# Buckets/Retention +curl -s -H "Authorization: Token $TK" "http://10.0.30.109:8086/api/v2/buckets?org=homelab" +``` + +## Related + +- [[systems/homeassistant]] — schreibende Integration, Recorder +- [[systems/hauswacht]] — read-only Analyst, der diese Kette nutzt (V-006) +- Solution: `docs/solutions/bug-fixes/2026-11-20-influxdb-drei-instanzen-yaml-luegt.md`