aza/AzA march 2026/security/handovers/STEP_12_MONITORING.md

STEP 12 – MONITORING & HEALTH CHECKS (MINIMAL)
Datum: 2026-02-22
Status: ABGESCHLOSSEN

=====================================================================
1. ZIEL
=====================================================================

Minimaler Betriebsnachweis:
- Services leben (Health-Checks)
- Metriken aus bestehenden Logs (kein externer Dienst)
- Integritaetspruefung automatisierbar
- Scheduling dokumentiert

Keine Patientendaten erfasst.

=====================================================================
2. HEALTH-CHECK ENDPOINTS
=====================================================================

Alle Services liefern jetzt unter /health:

  {
    "status": "ok",
    "version": "<app-version>",
    "uptime_s": <seconds>,
    "tls": true/false
  }

a) backend_main.py
   URL:     https://127.0.0.1:8000/health
   Vorher:  {"ok": true}
   Nachher: {"status": "ok", "version": "0.1.0", "uptime_s": ..., "tls": ...}

b) transcribe_server.py
   URL:     https://127.0.0.1:8090/health
   Vorher:  {"status": "ok"}
   Nachher: {"status": "ok", "version": "0.1.0", "uptime_s": ..., "tls": ...}

c) todo_server.py
   URL:     https://127.0.0.1:5111/health
   Vorher:  Kein /health Endpoint
   Nachher: {"status": "ok", "version": "1.0.0", "uptime_s": ..., "tls": ...}

d) Desktop-App (basis14.py)
   Kein HTTP-Endpoint (Desktop-App ohne eigenen Server).
   Betriebsnachweis ueber Audit-Log:
   - APP_START / APP_STOP Events
   - LOGIN_OK / LOGIN_FAIL Events

=====================================================================
3. MONITORING-METRIKEN (aza_monitoring.py)
=====================================================================

Quellen: Nur bestehende lokale Logs/Dateien. Kein Cloud-Dienst.

a) Audit-Log Metriken (aus aza_audit_log.py):
   - Anzahl LOGIN_FAIL
   - Anzahl AI_CHAT + AI_TRANSCRIBE (KI-Calls Zaehler)
   - Anzahl AI_BLOCKED
   - Anzahl 2FA_FAIL
   - Integritaets-Status (PASS/FAIL)

b) Consent-Log Metriken (aus aza_consent.py):
   - Anzahl Eintraege
   - Integritaets-Status

c) Backup-Metriken (aus backups/ Verzeichnis):
   - Anzahl vorhandener Backups
   - Letztes Backup (Name + Zeitpunkt)

d) Alert-Severity-Stufen:
   - INFO:     Zaehler ohne Handlungsbedarf
   - WARN:     Erhoehte Werte (z.B. > 0 login_fail)
   - HIGH:     Kritische Schwellen (z.B. >= 10 login_fail)
   - CRITICAL: Integritaets-Verletzung

=====================================================================
4. INTEGRITAETS-CHECKS
=====================================================================

Automatisierte Pruefung ueber:
  python aza_monitoring.py integrity

Prueft:
  - aza_audit_log: verify_all_rotations() (SHA-256 Hash-Kette)
  - aza_consent_log: verify_chain_integrity() (SHA-256 Hash-Kette)

Bei Fehler:
  - Klarer Log-Eintrag (INTEGRITY_FAIL Event ins Audit-Log)
  - Exit-Code 1 (fuer Scheduler-Alerting)

=====================================================================
5. CLI-KOMMANDOS
=====================================================================

  python aza_monitoring.py health      Health-Checks aller Services
  python aza_monitoring.py metrics     Metriken aus Logs
  python aza_monitoring.py integrity   Integritaetspruefung (Exit 0/1)
  python aza_monitoring.py alerts      Sicherheits-Alerts
  python aza_monitoring.py nightly     Naechtlicher Gesamtcheck + JSON-Report
  python aza_monitoring.py all         Alles anzeigen

=====================================================================
6. SCHEDULING-BEISPIELE
=====================================================================

a) Linux (cron):

  # Naechtlicher Gesamtcheck um 02:00
  0 2 * * * cd /pfad/zu/aza && python aza_monitoring.py nightly >> /var/log/aza_monitoring.log 2>&1

  # Stuendlicher Health-Check
  0 * * * * cd /pfad/zu/aza && python aza_monitoring.py health >> /var/log/aza_health.log 2>&1

  # Integritaet alle 6 Stunden
  0 */6 * * * cd /pfad/zu/aza && python aza_monitoring.py integrity || echo "INTEGRITY FAIL" | mail admin@example.com

b) Windows (Task Scheduler):

  Aktion: Programm starten
  Programm: python
  Argumente: aza_monitoring.py nightly
  Starten in: C:\Users\surov\Documents\AZA\backup 19.2.26

  Trigger: Taeglich, 02:00 Uhr

  Alternativ via PowerShell:

  $action = New-ScheduledTaskAction `
    -Execute "python" `
    -Argument "aza_monitoring.py nightly" `
    -WorkingDirectory "C:\Users\surov\Documents\AZA\backup 19.2.26"
  $trigger = New-ScheduledTaskTrigger -Daily -At "02:00"
  Register-ScheduledTask -TaskName "AZA Nightly Monitor" `
    -Action $action -Trigger $trigger -Description "AZA Nightly Monitoring"

=====================================================================
7. DATENSCHUTZ-HINWEIS (DATA MINIMIZATION)
=====================================================================

Das Monitoring erfasst KEINE:
- Patientennamen oder -daten
- Transkript-Inhalte oder Prompts
- Passwoerter oder API-Keys
- KI-Antworten

Es werden ausschliesslich Zaehler und Status-Informationen erhoben:
- Anzahl Events pro Typ
- PASS/FAIL Status
- Dateigeroessen und Zeitstempel
- Service-Version und Uptime

Health-Check-Responses enthalten nur technische Metadaten.

=====================================================================
8. TEST-ERGEBNIS
=====================================================================

Testskript: _test_monitoring.py
27 Tests, 0 Fehler.

Tests:
  1. Metriken: Audit-Log Eintraege, Integritaet, Backup-Count
  2. Alerts: login_fail, ai_calls_total, ai_blocked, 2fa_fail erkannt
  3. Integritaets-Check: PASS bei intaktem Log
  4. Manipulation: FAIL bei manipuliertem Log, PASS nach Restore
  5. Nightly-Report: JSON-Struktur korrekt, Datei geschrieben
  6. Data Minimization: Keine Passwoerter/Keys/Transkripte
  7. Health-Check Format: _APP_VERSION und _START_TIME vorhanden

=====================================================================
9. BETROFFENE DATEIEN
=====================================================================

Geaendert:
  - backend_main.py    (/health erweitert: version, uptime_s, tls)
  - transcribe_server.py  (/health erweitert: version, uptime_s, tls)
  - todo_server.py     (/health neu hinzugefuegt)

Neu:
  - aza_monitoring.py  (Monitoring, Metriken, Integrity, CLI)
  - _test_monitoring.py (Proof-Skript)

Nicht geaendert:
  - basis14.py
  - aza_audit_log.py (unveraendert, wird nur gelesen)
  - aza_consent.py (unveraendert, wird nur gelesen)

=====================================================================
10. RISIKEN
=====================================================================

- Health-Checks sind unauthentifiziert.
  Risiko: Gering (nur Status-Info, keine sensiblen Daten).
  Massnahme: Bei Bedarf hinter API-Token schuetzen.

- Monitoring laeuft lokal, kein externes Alerting.
  Risiko: Alerts werden nur im JSON-Report gespeichert.
  Massnahme: Nightly-Report per Mail weiterleiten (Empfehlung).

- Kein Real-Time-Monitoring.
  Risiko: Zwischenzeitliche Ausfaelle werden erst beim naechsten
  Scheduled-Check erkannt.
  Massnahme: Health-Check-Intervall anpassen (z.B. alle 5 Min).

=====================================================================
11. OFFENE PUNKTE
=====================================================================

Keine.