Monitoring und Gesundheit
Mnema Talk verrät eine Menge über sich selbst. Admin > Status ist die erste Anlaufstelle; für Alarme spricht es Prometheus.
Admin > Status
Der Owner und die Administratoren bekommen eine Übersicht: Version und Updates, Datenbankgröße und Migrationen, Objektspeicher und freier Plattenplatz, das letzte Backup und sein Restore-Test, die Aktivität live (Sitzungen, WebSocket-Verbindungen, Talks, Leute in Gesprächen) und die Setup-Prüfungen. Jede gelbe oder rote Prüfung nennt die Einstellung, die du ändern musst.
Das Panel Capacity zeigt CPU, Speicher und Medienverkehr live und für jede Art von Talk ungefähr, wie viele Leute reinpassen und ob zuerst CPU, Speicher oder Upload ausgeht. Test my connection prüft aus deinem Browser, ob Sprache den Server erreicht.
Admin > System (nur Owner) ergänzt Commit, Laufzeit und eine Betreiberansicht mit Diagrammen der letzten Stunde: Laufzeit, CPU, Speicher, Verkehr, Fehler und ICE-Fehlschläge.
Im Terminal: doctor
docker compose exec app mnema-talk doctor
Es gibt dieselben Prüfungen aus, eine Zeile je Prüfung mit [ ok ], [warn] oder [FAIL] und der Lösung unter jeder gelben oder roten, und endet mit Status 1, wenn eine Prüfung rot ist. Damit eignet es sich für Skripte.
Health-Endpunkte
| Endpunkt | Antwortet |
|---|---|
GET /api/health | 200 mit status, version und features, wenn die Datenbank antwortet und der Speicher erreichbar ist, sonst 503 mit dem, was ausgefallen ist |
GET /api/health/live | 200, solange der Prozess Anfragen bedient; fragt weder Datenbank noch Speicher |
Die Health-Prüfung von Compose nutzt /api/health. Ein Orchestrator, der bei einer fehlgeschlagenen Probe neu startet, muss stattdessen /api/health/live nehmen: Ein Neustart bringt den Speicher nicht zurück und würde jeden laufenden Talk beenden.
Metriken und Alarme
Setze METRICS_TOKEN (mindestens 24 Zeichen, openssl rand -hex 24) in der .env und führ docker compose up -d aus. GET /api/metrics antwortet dann im Prometheus-Format auf dieses Bearer-Token, und ohne es mit 404.
# prometheus.yml
scrape_configs:
- job_name: mnema-talk
metrics_path: /api/metrics
scheme: https
scrape_interval: 15s
authorization:
credentials: <METRICS_TOKEN>
static_configs:
- targets: ["chat.example.com"]
rule_files:
- mnema-alerts.yml
Schnelle Prüfung von Hand:
curl -H "Authorization: Bearer $METRICS_TOKEN" https://chat.example.com/api/metrics
Labels sind Routenmuster und feste Zustände, nie IDs von Nutzern oder Kanälen. Halte das Token aus den Access-Logs heraus und erlaube am Proxy, wenn du kannst, nur deinen Prometheus-Host.
Fertige Alarmregeln liegen in deploy/monitoring/mnema-alerts.yml und werden in der CI gegen die Metriken geprüft, die der Server exportiert:
| Alarm | Löst aus, wenn |
|---|---|
MnemaDown | Der Scrape 2 Minuten lang fehlschlägt |
MnemaStorageDown | Der Objektspeicher 5 Minuten lang nicht erreichbar ist |
MnemaHealthFailing | Die Probe von /api/health 3 Minuten lang fehlschlägt |
MnemaDatabasePoolExhausted | Jede Datenbankverbindung 5 Minuten lang belegt ist |
MnemaMemoryHigh | Der Speicher (resident) 15 Minuten lang über 800 MB liegt |
MnemaGoroutineLeak | 15 Minuten lang mehr als 5.000 Goroutinen laufen |
MnemaServerErrors | Mehr als ein 5xx alle 10 Sekunden über 10 Minuten |
MnemaSlowRequests | Die API-Latenz im 95. Perzentil 15 Minuten lang über einer Sekunde liegt |
MnemaIceFailures | Über 30 Minuten mehr als 20 % der Sprachverbindungen an ICE scheitern |
MnemaStorageErrors | In 15 Minuten mehr als 5 Fehler beim Objektspeicher auftreten |
MnemaGoroutinePanic | Der Server in den letzten 15 Minuten eine Panic abgefangen hat |
MnemaBackupTooOld | 36 Stunden lang kein erfolgreiches Backup |
Ein Prometheus-Container reicht für Diagramme und die Alarmliste; mit Alertmanager oder einem beliebigen Empfänger, der dessen Webhook-Format spricht (ntfy, Gotify, E-Mail), wirst du benachrichtigt. Ohne Prometheus deckt scripts/health-check.sh per Cron die Frage „läuft es?“ ab, mit Benachrichtigungen über Unraid oder Webhooks.
Logs
docker compose logs --since 10m app
Die Logs sind JSON-Zeilen und rotieren bei 3 × 10 MB pro Dienst. Für mehr Details setz LOG_LEVEL=debug, führ docker compose up -d aus, stell das Problem nach und nimm die Zeile wieder heraus. Auf einem Synology ohne Shell: Container Manager > Container > mnema-talk > Log.