Logging
Protokolliert Ereignisse des Servers in einem Log-Kanal — pro Ereignistyp abschaltbar.
Das Logging-Modul schreibt ausgewählte Ereignisse deines Servers als Embed in einen Log-Kanal. Du legst den Kanal fest und entscheidest pro Ereignistyp, ob er protokolliert wird. Das Modul arbeitet rein ereignisgesteuert, es gibt keine Befehle dafür. (logging)
Bild folgt
Das Dashboard mit geöffnetem Tab „Logging“: links die Modulliste, rechts die Einstellungen mit Speichern-Knopf.
Nur die Seite selbst zeigen – ohne Browserleiste, ohne persönliche Daten.
public/docs-assets/modules/logging.png · 1600x900 · dunkles Design
Wann überhaupt geloggt wird
Ein Ereignis landet nur dann im Log-Kanal, wenn drei Bedingungen zusammenkommen: Das Modul ist eingeschaltet, ein Log-Kanal ist gesetzt und der betreffende Ereignistyp ist aktiv. Fehlt einer dieser Punkte, wird die Nachricht verworfen.
- Fehlt ein einzelner Typ in den Einstellungen, gilt er als aktiv — nur ein ausdrückliches Ausschalten stoppt ihn.
- Der Log-Kanal im Tab Logging ist derselbe Wert wie im Tab General.
- Der Bot-Status läuft an dieser Logik vorbei (siehe unten).
Was die einzelnen Ereignis-Embeds enthalten
- Nachricht gelöscht
- Autor, Kanal, gekürzter Inhalt und Nachrichten-ID. Der Inhalt erscheint nur, wenn die Nachricht noch im Cache lag.
- Nachricht bearbeitet
- Autor, Kanal sowie alter und neuer Inhalt (je gekürzt). Wird nur gesendet, wenn sich der Inhalt tatsächlich geändert hat, und nie für Bot-Nachrichten.
- Kanal gelöscht
- Name, Typ (Text oder Voice) und ID des gelöschten Kanals.
- Timeout verhängt / aufgehoben
- Der betroffene Nutzer und, beim Verhängen, der Zeitpunkt, bis zu dem der Timeout läuft.
- Mitglied beigetreten / verlassen
- Nutzer, Account- bzw. Beitrittsdatum und die Mitgliederzahl.
Bot-Status wird global geloggt
Nicht über die Servereinstellungen steuerbar
Meldungen wie Bot online, Neustart, Bot gestoppt und Bot abgestürzt betreffen den Bot als Ganzes. Sie gehen an alle konfigurierten Log-Kanäle und lassen sich nicht pro Ereignistyp abschalten.Einstellungen im Dashboard
| Einstellung | Typ | Bedeutung |
|---|---|---|
Modul Logging aktivloggingEnabled | Schalter | Schaltet das Logging-Modul ein oder aus. Bei ausgeschaltetem Modul sind Kanal- und Ereignisauswahl nicht bearbeitbar. |
logChannellogChannel | Text | Kanal, in den die aktivierten Log-Embeds gesendet werden. Derselbe Wert wie im Tab General — ohne gesetzten Kanal wird nichts geloggt. |
Was wird geloggt?logTypes | Text | Sammelt sieben Schalter, alle standardmäßig aktiv: message_deleted (Nachricht gelöscht), message_edited (Nachricht bearbeitet), channel_deleted (Kanal gelöscht), user_timeout (Timeout verhängt), user_timeout_removed (Timeout aufgehoben), member_joined (Mitglied beigetreten), member_left (Mitglied verlassen).Standard: Alle aktiv |
Stolperfallen
- Logging läuft nur, wenn ein Log-Kanal gesetzt und das Modul aktiv ist.
- Der Bot-Status (online, Neustart, Crash) wird global verwaltet und nicht über die Servereinstellungen gesteuert.
- Der Kanal ist derselbe Wert wie im Tab General; eine Änderung wirkt in beiden Tabs.
Siehe auch