Audit-Log
Lückenlose Protokollierung aller relevanten Server-Ereignisse
Der Audit-Log schreibt automatisch Embed-Berichte in konfigurierte Channels, sobald auf deinem Server etwas Nennenswertes passiert — vom gelöschten Channel bis zum Rollen-Update. Die 23 Ereignisse sind in drei Kategorien gegliedert, damit du separate Channels für Nachrichten-, Mitglieder- und Server-Events führen kannst.
Einrichten
- Audit-Log-Modul aktivieren
- Drei dedizierte Log-Channels erstellen (empfohlen: #log-nachrichten, #log-mitglieder, #log-server)
- Im Dashboard die drei Channels zuweisen: Nachrichten-Channel, Mitglieder-Channel, Server-Channel
- Ereignisse aktivieren: alle 23 Ereignisse einzeln oder per Kategorie ein-/ausschalten
- Optional: Ignorierte Channels und Bots-ignorieren konfigurieren
- Speichern
Du kannst alle drei Kategorien in denselben Channel schicken. Separate Channels machen den Log aber deutlich übersichtlicher.
Alle 23 Ereignisse
Kategorie: Nachrichten
- messageUpdate — Nachricht bearbeitet — zeigt Original- und neuen Text
- messageDelete — Nachricht gelöscht — zeigt Inhalt (wenn im Cache vorhanden)
- inviteCreate — Einladung erstellt — zeigt Link, Ersteller und Ablaufdatum
Kategorie: Mitglieder
- guildMemberAdd — User beigetreten — mit Account-Alter und Erstell-Datum
- guildMemberRemove — User verlassen (freiwillig oder Kick)
- guildBanAdd — User gebannt — mit Grund, falls vorhanden
- guildBanRemove — User entbannt
- memberMuteTimeout — User per Discord-Timeout stummgeschaltet
- memberUnmuteTimeout — User-Timeout aufgehoben
- memberNicknameUpdate — Spitzname geändert — Alt + Neu nebeneinander
- userUpdate — User-Profil geändert (Avatar, globaler Name)
- memberRolesUpdate — Rollen hinzugefügt oder entfernt — zeigt Diff
- voiceJoin — User betritt Voice-Channel
- voiceLeave — User verlässt Voice-Channel
- voiceMove — User wechselt Voice-Channel (Von → Nach)
Kategorie: Server
- roleCreate — Neue Rolle erstellt
- roleUpdate — Rolle bearbeitet (Name, Farbe, Berechtigungen)
- roleDelete — Rolle gelöscht
- channelCreate — Neuer Channel erstellt
- channelUpdate — Channel bearbeitet (Name, Berechtigungen, Thema)
- channelDelete — Channel gelöscht
- guildUpdate — Server-Einstellungen geändert (Name, Icon, Beschreibung)
- emojisUpdate — Emojis hinzugefügt oder entfernt
Konfigurationsoptionen
Ignorierte Channels: Nachrichten-Events aus bestimmten Channels werden nicht protokolliert. Nützlich für sehr aktive Bot-Channels.
Bots ignorieren: Bot-Aktionen (z. B. wenn ein Bot eine Nachricht löscht) werden aus dem Log ausgeblendet. Standard: AN.
Jede Ereignis-Kategorie kann in einen anderen Channel geleitet werden. Wenn du keinen Nachrichten-Channel einträgst, werden Nachrichten-Events nicht geloggt — auch wenn sie aktiviert sind.
Empfohlene Konfiguration
- Erstelle drei separate private Channels nur für Mods: #log-nachrichten, #log-mitglieder, #log-server.
- Aktiviere initial alle 23 Ereignisse und deaktiviere dann nur, was zu viel Lärm macht (z. B. voiceJoin/Leave auf großen Servern).
- Trage sehr aktive Channels (z. B. Bot-Playground, #spam-off) in die Ignorierliste ein.
Häufige Fragen
- Warum fehlt der Inhalt bei gelöschten Nachrichten?
- Discord schickt den Nachrichteninhalt nur mit, wenn er im internen Cache des Bots liegt. Nachrichten, die älter als ca. 30 Minuten sind oder die der Bot nach einem Neustart nicht gesehen hat, erscheinen ohne Inhalt.
- Kann ich den Audit-Log für einzelne Rollen deaktivieren?
- Nicht pro Rolle, aber du kannst über "Bots ignorieren" alle Bot-Aktionen ausblenden. Für User-Rollen gibt es kein gezieltes Ausblenden.
- Werden Audit-Log-Embeds ins Audit-Log geschrieben? (Rekursion?)
- Nein. Der Bot erkennt eigene Aktionen und unterdrückt rekursives Logging.
- Wie lange werden Logs in Discord gespeichert?
- Discord selbst hat keine automatische Message-Deletion. Die Embeds bleiben so lange im Channel, bis sie manuell gelöscht oder durch Bulk-Delete entfernt werden.