📋 LOGGING SYSTEM

Das Logging System protokolliert Ereignisse auf deinem Server: wer beitritt oder geht, welche Nachrichten gelöscht oder bearbeitet werden, wer gebannt wird und was sich an Kanälen, Rollen, Sprachkanälen, Server-Einstellungen und Einladungen ändert. Jedes Ereignis erscheint als farbige Meldung in einem Discord-Kanal deiner Wahl – dem Log-Kanal.

Du schaltest das Modul mit einem Hauptschalter ein, wählst einen Standard-Log-Kanal und aktivierst die Ereignisse einzeln oder als ganze Kategorie. Jedes Ereignis kann zusätzlich in einen eigenen Kanal gehen, etwa Beitritte nach #member-log.

• Absender „THE GRID Logging“: Der Bot postet die Meldungen über einen Webhook, den er beim ersten Log im Kanal selbst anlegt. Dafür braucht er dort das Recht „Webhooks verwalten“ – siehe Rechte.
• Sofort wirksam: Änderungen gelten, sobald du sie gespeichert hast. Eine Testnachricht gibt es nicht; der erste Log erscheint beim nächsten passenden Ereignis.
• Keine Tarifgrenze: Das Logging System ist in allen Tarifen ohne Begrenzung enthalten, auch in Free.
• Zugriff: Einrichten können nur der Server-Besitzer und Mitglieder mit der Discord-Berechtigung „Administrator“.

The Logging System records events on your server: who joins or leaves, which messages are deleted or edited, who gets banned and what changes in channels, roles, voice channels, server settings and invites. Each event appears as a coloured message in a Discord channel of your choice – the log channel.

You switch the module on with a main switch, choose a default log channel and enable the events one by one or as a whole category. Each event can also go to a channel of its own, for example joins to #member-log.

• Sender “THE GRID Logging”: the bot posts the messages through a webhook that it creates in the channel with the first log. For that it needs the “Manage Webhooks” permission there – see Permissions.
• Effective immediately: changes apply as soon as you have saved them. There is no test message; the first log appears with the next matching event.
• No plan limits: the Logging System is included in every plan without limits, including Free.
• Access: only the server owner and members with the Discord permission “Administrator” can set it up.

Die Einstellungen

Gut zu wissen

• Nichts speichert automatisch. Verlässt du die Seite ohne „Alle Einstellungen speichern“, sind deine Änderungen ohne Warnung weg.
• Kein Testlog: Zum Ausprobieren schreibst du selbst eine Nachricht und bearbeitest sie – ist „Nachricht bearbeitet“ an, erscheint kurz darauf der Log.
• Neuer Kanal fehlt in der Liste? Neu angelegte Kanäle können ein paar Minuten brauchen, bis sie erscheinen. Lade die Seite dann neu.
• Eindeutige Kanalnamen: Die Kanal-Auswahlen listen alle Text-Kanäle mit # und Namen – ohne Kategorien und nicht sortiert. Gib Log-Kanälen deshalb Namen, die du leicht wiederfindest.

The settings

Good to know

• Nothing is saved automatically. If you leave the page without “Save all settings”, your changes are lost without a warning.
• No test log: to try it out, write a message yourself and edit it – if “Message edited” is on, the log appears shortly afterwards.
• New channel missing from the list? Newly created channels can take a few minutes to appear. Then reload the page.
• Clear channel names: the channel selections list every text channel with # and its name – without categories and unsorted. So give log channels names that are easy to find.

Hat die Rolle des Bots die Berechtigung „Administrator“ – so wird er eingeladen –, ist alles abgedeckt. Sonst braucht er diese Rechte:

Die Moderationsübersicht prüft diese Rechte nicht – anders als bei Welcome Setup oder Ban-Channel gibt es für das Logging kein Status-Abzeichen. So gibst du dem Bot das Recht im Log-Kanal: Rechtsklick auf den Kanal → „Kanal bearbeiten“ → „Berechtigungen“ → Rolle „THE GRID“ hinzufügen → „Webhooks verwalten“ erlauben.

If the bot's role has the “Administrator” permission – that is how it is invited – everything is covered. Otherwise it needs these permissions:

The moderation overview does not check these permissions – unlike Welcome Setup or the ban channel, logging has no status badge. To grant the permission in the log channel: right-click the channel → “Edit Channel” → “Permissions” → add the “THE GRID” role → allow “Manage Webhooks”.

Die Ereignisse sind in sechs Kategorien sortiert. Die Tabellen zeigen, wann ein Log entsteht, was darin steht und wo die Grenzen liegen. Wie die Meldungen aussehen, zeigen die Beispiele.

Mitglieder

Nachrichten

Kanäle

Rollen

Voice

Server

The events are sorted into six categories. The tables show when a log is created, what it contains and where its limits are. The examples show what the messages look like.

Members

Messages

Channels

Roles

Voice

Server

Jeder Log – außer dem News-Log – ist eine eingebettete Nachricht vom Absender „THE GRID Logging“ mit dem Profilbild des Bots: links ein Farbbalken, oben meist Name und Profilbild des betroffenen Mitglieds, dann Titel und Felder, rechts ein Vorschaubild und unten eine Fußzeile mit ID und Uhrzeit.

• Grün – etwas kommt hinzu: Beitritt, Entbannung, neuer Kanal, Sprachkanal betreten, neue Einladung.
• Rot – etwas fällt weg: Austritt, Bann, gelöschte Nachricht, gelöschter Kanal oder gelöschte Rolle, Sprachkanal verlassen, gelöschte Einladung.
• Orange – etwas ändert sich: Mitglied, Nachricht, Kanal, Wechsel des Sprachkanals; auch „User gekickt“.
• Blau – Server-Änderungen. Neue und geänderte Rollen erscheinen in der Farbe der Rolle.
• Fußzeile: je nach Ereignis „ID:“, „Msg-ID:“, „Channel-ID:“, „Role-ID:“, „Code:“ oder „Server-ID:“ mit der passenden Nummer. Bei /kick und /ban steht dort „THE GRID Logging“.

Bann mit /ban: zwei Einträge

Bannt ein Moderator mit dem Bot-Befehl /ban, kommen zwei Meldungen: „User gebannt“ von THE GRID mit Moderator, Grund und Gesamtpunkten – und die allgemeine Bann-Meldung „🔨 Mitglied gebannt“, die den Grund nicht kennt. Ist „Mitglied verlassen“ an, folgt ein dritter Eintrag. Bei /kick kommen entsprechend „User gekickt“ und „📤 Mitglied verlassen“.

Auch der Ban-Channel erzeugt mehrere Einträge: „🗑️ Nachricht gelöscht“ für die gelöschte Nachricht, „🔨 Mitglied gebannt“ ohne Grund und „📤 Mitglied verlassen“ – jeweils, wenn das Ereignis eingeschaltet ist.

Der News-Log

Der News-Log sieht anders aus, weil ihn das Dashboard mit dem Bot-Konto schickt statt über den Webhook: fett der Titel, eine Trennlinie, der Text, auf Wunsch das Bild, eine Trennlinie und Datum und Uhrzeit. Eine Überschrift „News“, den Autor oder die Kategorie enthält er nicht.

Every log – except the news log – is an embedded message from the sender “THE GRID Logging” with the bot's avatar: a colour bar on the left, usually the affected member's name and avatar at the top, then the title and fields, a thumbnail on the right and a footer with an ID and the time at the bottom.

• Green – something is added: a join, an unban, a new channel, joining a voice channel, a new invite.
• Red – something goes away: a member leaving, a ban, a deleted message, a deleted channel or role, leaving a voice channel, a deleted invite.
• Orange – something changes: a member, a message, a channel, switching voice channels; also “User Kicked”.
• Blue – server changes. New and changed roles appear in the role's colour.
• Footer: depending on the event “ID:”, “Msg-ID:”, “Channel-ID:”, “Role-ID:”, “Code:” or “Server-ID:” with the matching number. For /kick and /ban it says “THE GRID Logging”.

Banning with /ban: two entries

When a moderator bans with the bot command /ban, two messages arrive: “User Banned” from THE GRID with moderator, reason and total points – and the general ban message “🔨 Member Banned”, which does not know the reason. If “Member left” is on, a third entry follows. /kick accordingly produces “User Kicked” and “📤 Member Left”.

The ban channel also creates several entries: “🗑️ Message Deleted” for the deleted message, “🔨 Member Banned” without a reason and “📤 Member Left” – each only if the event is switched on.

The news log

The news log looks different because the dashboard sends it with the bot account instead of through the webhook: the title in bold, a divider, the text, optionally the image, another divider and the date and time. It has no “News” heading, no author and no category.

Das Logging System zeigt vieles, aber nicht alles. Diese Grenzen solltest du kennen.

Gelöschte Nachrichten

• Den Inhalt zeigt der Log nur, wenn der Bot die Nachricht kennt. Der Bot merkt sich Nachrichten etwa 24 Stunden lang – aber nur seit seinem letzten Neustart. Bei älteren Nachrichten steht statt des Inhalts „Inhalt nicht verfügbar (Nachricht nicht gecached)“.
• Nachrichten nur mit Anhang – Bild, Datei oder Sticker – zeigen ebenfalls „Inhalt nicht verfügbar“; genannt wird die Anzahl der Anhänge. Die Dateien selbst hält der Log nicht fest.
• Wer gelöscht hat, zeigt der Log nur ausnahmsweise – im Feld „🗑️ Gelöscht von“. Das klappt nur bei unbekannten Nachrichten oder Nachrichten ohne Text, wenn der Bot „Audit-Log anzeigen“ hat und Discord das Löschen im Audit-Log vermerkt. Discord vermerkt es nur, wenn jemand die Nachricht eines anderen löscht.

Banns, Kicks und Verwarnungen

• Banns ohne Grund und Moderator: „🔨 Mitglied gebannt“ zeigt immer „Kein Grund angegeben“ und nicht, wer gebannt hat – beides steht im Audit-Log von Discord. Bei /ban kommen zwei Einträge, siehe Beispiele.
• Kicks nur über /kick: Kicks über Discord selbst erscheinen nur als „Mitglied verlassen“.
• Verwarnungen erscheinen nie im Log. Du findest sie im Warn System.

Was gar nicht protokolliert wird

• Stummschalten, Taubschalten, Streams und Kamera im Sprachkanal.
• Emojis – weder neue noch gelöschte.
• Bei Kanälen alles außer Name, Thema, NSFW, Slowmode, Bitrate und Benutzerlimit; bei Rollen alles außer Name, Farbe, Hervorhebung, Erwähnbarkeit, Berechtigungen (ohne Einzelheiten) und Position; beim Server alles außer Name, Icon, Banner, Beschreibung, Verifizierungslevel, AFK-Kanal und AFK-Timeout.
• Threads, globale Profiländerungen (Benutzername, Profilbild) und Boosts.
• Ausnahmelisten gibt es nicht: Du kannst keine Kanäle, Rollen oder Mitglieder vom Logging ausnehmen.

Weitere Eigenheiten

• Bei gelöschten Einladungen steht unter „Nutzungen“ immer „Unbekannt“.
• Kurz nach einem Neustart des Bots kann „Mitglied aktualisiert“ falsche Vorher-Werte zeigen, zum Beispiel alle Rollen als „hinzugefügt“.
• Rollen ohne Farbe erscheinen mit „#000000“.

The Logging System shows a lot, but not everything. These are the limits you should know.

Deleted messages

• The log only shows the content if the bot knows the message. The bot remembers messages for about 24 hours – but only since its last restart. For older messages you see “Content unavailable (message not cached)” instead of the content.
• Messages with only an attachment – image, file or sticker – also show “Content unavailable”; the number of attachments is given. The log does not keep the files themselves.
• Who deleted a message is shown only in exceptional cases – in the field “🗑️ Gelöscht von” (deleted by). This only works for unknown messages or messages without text, if the bot has “View Audit Log” and Discord records the deletion in the audit log. Discord only records it when someone deletes another person's message.

Bans, kicks and warnings

• Bans without reason or moderator: “🔨 Member Banned” always shows “No reason provided” and not who banned – both are in Discord's audit log. With /ban you get two entries, see Examples.
• Kicks only via /kick: kicks done in Discord itself only appear as “Member left”.
• Warnings never appear in the log. You find them in the Warn System.

What is not logged at all

• Muting, deafening, streaming and camera in voice channels.
• Emojis – neither new nor deleted ones.
• For channels everything except name, topic, NSFW, slowmode, bitrate and user limit; for roles everything except name, colour, hoisting, mentionability, permissions (without details) and position; for the server everything except name, icon, banner, description, verification level, AFK channel and AFK timeout.
• Threads, global profile changes (username, avatar) and boosts.
• There are no ignore lists: you cannot exclude channels, roles or members from logging.

Other quirks

• For deleted invites, “Uses” always shows “Unknown”.
• Shortly after the bot restarts, “Member updated” can show wrong before values, for example all roles as “added”.
• Roles without a colour appear as “#000000”.

Die Logs erscheinen in der Hauptsprache deines Servers in Discord (Server-Einstellungen → Community → Übersicht) – nicht in der Sprache deines Dashboards. Beginnt sie mit Deutsch, sind die Logs deutsch, bei Englisch englisch und bei jeder anderen Sprache deutsch. Server ohne Community-Funktion bekommen englische Logs. Das gilt auch für die Einträge von /kick und /ban. Mehr dazu in der Übersicht.

• „🗑️ Gelöscht von“ ist auch in englischen Logs deutsch.
• Die Fußzeilen („ID:“, „Msg-ID:“ usw.) sind in beiden Sprachen gleich.
• Der News-Log enthält nur deinen Text und den Zeitpunkt.
• Datum und Uhrzeit zeigt Discord in der Regel in der Sprache des Lesers an.

Logs appear in your server's primary language in Discord (Server Settings → Community → Overview) – not in your dashboard language. If it starts with German, the logs are German; with English, English; with any other language, German. Servers without the Community feature get English logs. This also applies to the entries from /kick and /ban. More in the overview.

• “🗑️ Gelöscht von” (deleted by) is German even in English logs.
• The footers (“ID:”, “Msg-ID:” and so on) are the same in both languages.
• The news log only contains your text and the time.
• Discord usually shows dates and times in the reader's language.

Fehler zeigt das Logging System weder im Dashboard noch in Discord an – die Logs bleiben einfach aus. Geh diese Liste der Reihe nach durch:

1. Hauptschalter: Ist „Logging aktiviert“ an – und hast du danach „Alle Einstellungen speichern“ geklickt?
2. Ereignis: Ist der kleine Schalter des Ereignisses an? Der Kategorie-Schalter allein sagt wenig, denn er steht nur auf „an“, wenn alle Ereignisse der Kategorie an sind.
3. Kanal: Ist ein Log-Kanal gewählt – oder beim Ereignis ein eigener Kanal? Ohne Kanal gibt es keine Logs und keine Warnung.
4. Rechte: Hat der Bot im Kanal „Kanal ansehen“ und „Webhooks verwalten“? Für Einladungs-Logs braucht er „Kanäle verwalten“, für den News-Log „Nachrichten senden“. Details unter Rechte.
5. Webhook gelöscht? Wurde der Webhook „THE GRID Logging“ im Kanal gelöscht, bleiben die Logs dort aus. Wähle einen anderen Kanal als Log-Kanal und speichere – dort legt der Bot einen neuen Webhook an.
6. Kanal gelöscht? Ist der Standard-Log-Kanal weg, ist die Auswahl leer: neuen Kanal wählen und speichern. Ist der eigene Kanal eines Ereignisses weg, gehen diese Logs nicht von selbst in den Standard-Kanal. Das passiert erst, wenn du die Seite einmal neu speicherst – oder du wählst gleich einen neuen Kanal.
7. Zu viele Webhooks? Discord erlaubt nur eine begrenzte Zahl von Webhooks pro Kanal (derzeit 15). Ist der Kanal voll, kann der Bot keinen eigenen anlegen – wähle einen anderen Kanal.
8. Kanal sichtbar? Aus Kanälen, die der Bot nicht sehen kann, kommen keine Nachrichten-Logs.

Meldungen auf der Seite

Die Zusätze nach „Fehler beim Laden“ kommen immer auf Englisch. Der Knopf „Erneut versuchen“ führt zurück zur Serverauswahl; er lädt die Seite nicht neu.

The Logging System shows errors neither in the dashboard nor in Discord – the logs simply do not arrive. Work through this list in order:

1. Main switch: is “Logging enabled” on – and did you click “Save all settings” afterwards?
2. Event: is the event's small switch on? The category switch alone says little, because it only shows “on” when every event in the category is on.
3. Channel: is a log channel selected – or a channel of its own for the event? Without a channel there are no logs and no warning.
4. Permissions: does the bot have “View Channel” and “Manage Webhooks” in the channel? For invite logs it needs “Manage Channels”, for the news log “Send Messages”. Details under Permissions.
5. Webhook deleted? If the “THE GRID Logging” webhook in the channel was deleted, logs stop there. Choose a different channel as log channel and save – the bot creates a new webhook there.
6. Channel deleted? If the default log channel is gone, the selection is empty: pick a new channel and save. If an event's own channel is gone, these logs do not fall back to the default channel by themselves. That only happens once you save the page again – or you pick a new channel right away.
7. Too many webhooks? Discord only allows a limited number of webhooks per channel (currently 15). If the channel is full, the bot cannot create its own – choose a different channel.
8. Channel visible? Channels the bot cannot see produce no message logs.

Messages on the page

The “Try again” button takes you back to the server selection; it does not reload the page.