Server-Statistiken
Aktivitäts-Insights und Wachstumsdaten auf einen Blick
Server-Statistiken zeigt dir auf einen Blick, wie aktiv dein Server ist — wer die aktivsten Mitglieder sind, wann deine Community online ist, und wie sich dein Server über Zeit entwickelt. Alle Daten werden über schlanke Redis-Counter live erfasst und alle 5 Minuten in die Datenbank geflusht, sodass das Dashboard immer aktuell bleibt, ohne die Bot-Performance zu beeinflussen.
Übersicht
Der Tab Statistiken im Dashboard zeigt einen Live-Snapshot des Zustands deines Servers. Die Seite ist in Widget-Cards aufgeteilt, die sich jeweils auf einen bestimmten Aspekt der Server-Aktivität konzentrieren. Daten werden fortlaufend aktualisiert; Charts zeigen standardmäßig die letzten 90 Tage.
Widgets
Die Statistikseite enthält folgende Widgets:
| Widget | Beschreibung |
|---|---|
| 6 Hero-Stat-Cards | Mitglieder gesamt, gerade online, Nachrichten heute, Nachrichten diese Woche, neue Beitritte diese Woche und aktive Voice-Sessions — als große Zahlenkarten oben auf der Seite. |
| Mitgliederwachstum-Chart | Liniendiagramm mit Beitritten und Abgängen der letzten 30 Tage, inkl. Netto-Wachstums-Indikator. |
| Aktivitäts-Heatmap | 7×24-Raster, das die Nachrichtenanzahl pro Stunde über die letzten 90 Tage zeigt. Dunklere Felder = mehr Aktivität. Ideal, um Peak-Zeiten zu identifizieren. |
| Top-Channels | Balkendiagramm der 10 aktivsten Text-Channels nach Nachrichtenanzahl im gewählten Zeitraum. |
| Top-Mitglieder | Rangliste der 10 aktivsten Mitglieder nach Nachrichtenanzahl. Kein Nachrichteninhalt wird gespeichert — nur Zählungen. |
| Moderationstrend | Liniendiagramm mit Verwarnung-, Mute-, Kick- und Ban-Aktionen der letzten 30 Tage. |
| Modul-Aktivitätskarten | Eine Karte pro aktiviertem Modul (z. B. Leveling, YouTube-Benachrichtigungen, DayZ-Killfeed) mit der Anzahl der erfassten Events. |
So funktioniert es
Statistiken werden über eine schlanke Event-Pipeline erfasst:
- Jedes relevante Discord-Event (Nachricht, Beitritt, Abgang, Mod-Aktion) löst ein Redis-INCR auf einem zeitgestempelten Key aus.
- Alle 5 Minuten schreibt ein Hintergrundjob die Redis-Counter als Stundenaggregate in die Datenbank.
- Einmal pro Stunde führt der Aggregator die Sub-Stunden-Buckets zu einem einzigen Stundendatensatz pro Metrik zusammen.
- Daten außerhalb des Aufbewahrungszeitraums werden jede Nacht um 03:00 Uhr UTC automatisch gelöscht.
Datenschutz & Aufbewahrungsfristen
Server-Statistiken speichert ausschließlich aggregierte Zählwerte — niemals Nachrichteninhalte, Nutzer-IDs verknüpft mit Nachrichtentext oder andere personenbezogene Daten über Beitritts- und Abgangszeitstempel hinaus. Folgende Datenkategorien werden aufbewahrt:
| Datentyp | Aufbewahrung |
|---|---|
| Stündliche Nachricht- & Voice-Aktivität | 90 Tage |
| Mitglieder-Beitritts- und Abgangs-Events | 365 Tage |
| Moderationsaktionen (Verwarnung, Mute, Kick, Ban) | 365 Tage |
Die automatische Bereinigung läuft jede Nacht um 03:00 Uhr UTC. Ältere Datensätze werden dauerhaft gelöscht und können nicht wiederhergestellt werden.
Fehlerbehebung
- Charts sind direkt nach dem Aktivieren der Statistiken leer
- Das ist normal. Der erste Flush findet innerhalb von 5 Minuten statt; Heatmap und Charts benötigen mindestens einen Flush-Zyklus, bevor sie Daten anzeigen. Warte 5–10 Minuten und lade das Dashboard dann neu.
- Channel-Namen erscheinen als rohe IDs (z. B. <#1234567890>)
- Der Bot benötigt die Berechtigung 'Kanäle anzeigen', um Channel-Namen auflösen zu können. Prüfe, ob TeraOne diese Berechtigung auf Server-Ebene hat und ob sie nicht für einzelne Channels auf 'Verweigert' überschrieben wurde.
- Eine Modul-Aktivitätskarte zeigt '—' statt einer Zahl
- Das betreffende Modul ist entweder deaktiviert oder hat noch keine Events erfasst. Aktiviere das Modul in seinem eigenen Einstellungs-Tab und löse mindestens ein Event aus (z. B. eine Nachricht senden, um Leveling-Daten zu sammeln).
Häufige Fragen
- Werden Nachrichteninhalte durch Statistiken erfasst?
- Nein. Es wird ausschließlich die Anzahl der Nachrichten pro Channel pro Stunde gespeichert. Der tatsächliche Text wird zu keinem Zeitpunkt gelesen, gespeichert oder übermittelt.
- Können Mitglieder sich vom Zählen abmelden?
- Statistiken sind derzeit serverweite Aggregate. Einzelne Nachrichtenzählungen für Top-Mitglieder werden pro Nutzer-ID gespeichert, jedoch ohne Nachrichteninhalt. Eine Opt-out-Option pro Nutzer ist für eine spätere Version geplant.
- Wie weit reichen die Charts zurück?
- Die Aktivitäts-Heatmap sowie Channel- und Mitglieder-Charts nutzen bis zu 90 Tage stündliche Daten. Mitgliederwachstum und Moderationstrends werden 365 Tage aufbewahrt.
- Warum weicht die Mitgliederzahl in der Hero-Card von Discords Mitgliederliste ab?
- Die Hero-Card zeigt den Stand beim letzten Daten-Flush (bis zu 5 Minuten zurück). Discords Mitgliederliste ist immer live. Bei starken Beitritts-/Abgangswellen kann es bis zum nächsten Flush-Zyklus eine kurze Abweichung geben.
- Kann ich die Statistikdaten exportieren?
- Ein CSV-Export-Button befindet sich oben rechts in jeder Chart-Card. Er exportiert die rohen Stundendaten der aktuell angezeigten Chart-Ansicht.