Monitoring & Health-Checks
AdminDen Zustand der Anwendung im Web-/Server-Betrieb überwachen: über HTTP-Health-Endpunkte, OpenTelemetry-Telemetrie und die in der App sichtbaren Audit-Protokolle.
Health-Endpunkte (Web/Docker)
Section titled “Health-Endpunkte (Web/Docker)”| Endpunkt | Zweck | Inhalt |
|---|---|---|
/health | Gesamtstatus | alle Prüfungen müssen grün sein |
/alive | Liveness | nur als „live” markierte Prüfungen (App reagiert?) |
/ready | Readiness | nur als „ready” markierte Prüfungen (Traffic annehmbar?) |
Registriert in den ServiceDefaults (MapDefaultEndpoints). Der Docker-HEALTHCHECK prüft /alive alle 30 s (15 s Startkarenz). In Kubernetes eignen sich /alive als Liveness- und /ready als Readiness-Probe.
Zusätzliche Prüfungen je nach Konfiguration: SMTP (Start-Probe), Qdrant, Presidio.
OpenTelemetry
Section titled “OpenTelemetry”Exportiert Metriken (ASP.NET-Core-, HTTP-Client- und Runtime-Instrumentierung), Traces (Requests/HTTP-Aufrufe; Health-Pfade ausgenommen) und Logs. Der Export ist aktiv, sobald OTEL_EXPORTER_OTLP_ENDPOINT gesetzt ist (OTLP, z. B. auf einen Collector/das Aspire-Dashboard). Optional ist eine Sentry-Anbindung (DSN-gesteuert).
Was Admins in der App sehen
Section titled “Was Admins in der App sehen”- Nutzung – Token/Kosten/Anfragen/Latenz. → Nutzungsstatistiken
- Audit-Protokolle – Schreibvorgänge auf der Wissensbasis sowie PII-Audit. → Audit-Protokoll (PII)
- Dienst-Status – SMTP-/Qdrant-/Presidio-Health in den Systemeinstellungen.
Desktop: keine Health-Endpunkte; Beobachtung über die App-Tabs (Nutzung, Audit, Dienst-Status) und lokale Logs.
Verifikation
Section titled “Verifikation”curl http://<host>:8080/alive→ HTTP 200;/ready→ 200, sobald Abhängigkeiten bereit sind.- Telemetrie erscheint im Collector/Dashboard (wenn OTLP-Endpoint gesetzt).
Troubleshooting
Section titled “Troubleshooting”/readybleibt 503 – eine „ready”-Prüfung (z. B. Datenbank) schlägt fehl; Logs prüfen.- Keine Telemetrie –
OTEL_EXPORTER_OTLP_ENDPOINTfehlt/falsch oder Collector nicht erreichbar. - Presidio „nicht erreichbar” – PII-Pseudonymisierung degradiert; siehe Presidio einrichten.