monitoring: Betriebsüberwachung Phase 1 — GlitchTip (Server- und Browserfehler), Fehlersignale ohne Exception, /health mit Scheduler-Herzschlag, ntfy-Alarme, fehlgeschlagene Anmeldungen im Verlauf, Umami im Kundenbereich, Versionsnummer

- GlitchTip über die Sentry-SDKs; Datenschutzfilter (nur User-ID, keine
  Request-Bodys, Tokens aus URL/Query/Referer, E-Mails aus Meldungen).
  Browser-SDK erst beim ersten Fehler nachgeladen.
- ReportErrorSignals: tote interne Links (404 mit eigenem Referrer), 403/429
  für Angemeldete, 419 als gedrosselte Warnung.
- /health (Bearer-Token): DB, Cache, Queue-Rückstau, Scheduler-Herzschlag,
  Plattenplatz → 200/503; Scheduler und Plattenplatz auch im Systemstatus.
- OperationalAlert zusätzlich per ntfy (JSON-POST), unabhängig von der Mail.
- Verlauf: login_failed (Grund unbekannt/kein Passwort/falsch),
  login_lockout, two_factor_failed; IP nur als gekürzter HMAC.
- Umami: Kundenbereich mit eigenem Schalter und identify('user-<id>'),
  nie im Admin/bei Impersonation; Query-Filter auch auf den Webseiten
  (signierte Links gingen bisher an Umami).
- queue:prune-failed nach 30 Tagen.
- Versionsnummer: config('app.version') aus APP_VERSION oder Datei RELEASE
  (git describe --tags), in GlitchTip, /health, Systemstatus, artisan about.

Plan: dev/betrieb/monitoring-plan.md (Entscheidungen M1–M9).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Kevin Adametz 2026-10-05 12:53:00 +00:00
parent 2079dfdaa8
commit d884eb7482
42 changed files with 1896 additions and 9 deletions

View file

@ -36,6 +36,22 @@ LOG_LEVEL=debug
# gemeldet (Fallback: LEGAL_CONTACT_EMAIL). In Prod echten Mailer voraussetzen.
MONITORING_ALERTS_ENABLED=true
MONITORING_ALERT_EMAIL=
# Zweiter Alarmweg per ntfy (Monitoring-Plan M3) — ohne URL/Topic aus.
MONITORING_NTFY_URL=
MONITORING_NTFY_TOPIC=
MONITORING_NTFY_TOKEN=
MONITORING_NTFY_PRIORITY=4
# Tiefer Health-Check /health für den externen Monitor (Bearer oder ?token=).
# Ohne Token gibt es den Endpunkt nicht.
MONITORING_HEALTH_TOKEN=
# Fehler an GlitchTip (selbst gehostet, Sentry-Protokoll; Monitoring-Plan
# 1.1/1.2). Ohne DSN passiert nichts. SENTRY_RELEASE bei jedem Deploy auf
# den Git-Hash setzen, dann ordnet GlitchTip Fehler der Version zu.
SENTRY_LARAVEL_DSN=
SENTRY_BROWSER_DSN=
SENTRY_ENVIRONMENT=
SENTRY_RELEASE=
# ---------------------------------------------------------------------------
# Multi-Domain-Setup (config/domains.php)
@ -254,6 +270,10 @@ BILLING_DEPUBLICATION_PRICE_CENTS=3500
# config/domains.php). Erst beim Go-Live der Webseiten auf true setzen —
# die Datenschutzerklärung (Abschnitt 5) beschreibt den Einsatz bereits.
UMAMI_ENABLED=false
# Kundenbereich und Zuordnung zur User-ID getrennt (Monitoring-Plan M6) —
# erst nach Ergänzung der Datenschutzerklärung einschalten.
UMAMI_PORTAL_ENABLED=false
UMAMI_IDENTIFY_USERS=false
# Haupt-E-Mail für alle rechtlichen Anliegen (Impressum, Datenschutz, AGB,
# Meldeverfahren, Richtlinien) — auf allen drei Domains identisch.