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

EndpunktAntwortet
GET /api/health200 mit status, version und features, wenn die Datenbank antwortet und der Speicher erreichbar ist, sonst 503 mit dem, was ausgefallen ist
GET /api/health/live200, 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:

AlarmLöst aus, wenn
MnemaDownDer Scrape 2 Minuten lang fehlschlägt
MnemaStorageDownDer Objektspeicher 5 Minuten lang nicht erreichbar ist
MnemaHealthFailingDie Probe von /api/health 3 Minuten lang fehlschlägt
MnemaDatabasePoolExhaustedJede Datenbankverbindung 5 Minuten lang belegt ist
MnemaMemoryHighDer Speicher (resident) 15 Minuten lang über 800 MB liegt
MnemaGoroutineLeak15 Minuten lang mehr als 5.000 Goroutinen laufen
MnemaServerErrorsMehr als ein 5xx alle 10 Sekunden über 10 Minuten
MnemaSlowRequestsDie API-Latenz im 95. Perzentil 15 Minuten lang über einer Sekunde liegt
MnemaIceFailuresÜber 30 Minuten mehr als 20 % der Sprachverbindungen an ICE scheitern
MnemaStorageErrorsIn 15 Minuten mehr als 5 Fehler beim Objektspeicher auftreten
MnemaGoroutinePanicDer Server in den letzten 15 Minuten eine Panic abgefangen hat
MnemaBackupTooOld36 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.

Stimmt etwas auf dieser Seite nicht? Sag es uns.