Protokollierungssystem

Verfolgen Sie alles, was in Ihrem Server passiert, mit 55 Ereignistypen, die in 18 Kategorien organisiert sind, kanalbezogener Weiterleitung pro Kategorie und benutzerdefinierten Embed-Farben – alles über das Dashboard konfiguriert.

Topics: logs, logging, audit, events, tracking

Übersicht

Das Protokollierungssystem zeichnet Serverereignisse auf und veröffentlicht detaillierte Embeds in den von Ihnen gewählten Kanälen. Es ist das Rückgrat für die Verantwortlichkeit der Moderation und die allgemeine Sichtbarkeit: Wer beigetreten ist, was gelöscht wurde, welche Rollen geändert wurden, wer gesperrt wurde und vieles mehr.

Alles wird über Dashboard → Protokolle konfiguriert. Nichts ist standardmäßig aktiviert – Sie entscheiden genau, welche Kategorien verfolgt werden und wo jede einzelne gesendet wird. Für einen Ein-Kommando-Shortcut, der alles in einem einzigen Kanal aktiviert, siehe die Protokollbefehle.

Aktivierung und grundlegende Einrichtung

Öffnen Sie Dashboard → Protokolle für Ihren Server.
Aktivieren Sie Aktiv im Seitenkopf, um das System einzuschalten.
Verwenden Sie den Alle Protokollkanal-Wähler im Kopfbereich, um *jede* Kategorie in einen Kanal zu senden – der schnellste Weg, um zu starten.
Oder erweitern Sie eine der Kategorien unten, um ihr einen eigenen Kanal zu geben und aktivieren Sie sie.

Tipp: Netrcol benötigt Kanal anzeigen, Nachrichten senden, Links einbetten und Nachrichtenverlauf lesen in jedem Kanal, in den Sie protokollieren. Der Setup-Gesundheitscheck auf der Seite warnt Sie, wenn eine Berechtigung fehlt.

Kanäle pro Kategorie

Jede Kategorie ist eine erweiterbare Zeile mit ihrem eigenen Kanalwähler und Ein/Aus-Umschalter. Dies ermöglicht es Ihnen, Ihre Protokolle über verschiedene Kanäle zu verteilen – zum Beispiel Moderationsprotokolle in einem privaten Mitarbeiterkanal und Beitritts/Austrittsprotokolle in einem öffentlichen.

Wenn jede Kategorie auf denselben Kanal verweist, zeigt der Kopfbereich Alle Protokollkanal-Wähler diesen Kanal an; wenn sie unterschiedlich sind, wird *„Kanäle unterscheiden sich.“* angezeigt. Wenn Sie es erneut einstellen, wird alles wieder auf einen einzigen Kanal verwiesen.

Embed-Farben

Jedes Ereignis hat einen Farbstreifen, den Sie anpassen können. Öffnen Sie eine Kategorie, und jede Ereigniszeile hat eine Farbpalette – praktisch, um Kategorien auf einen Blick zu unterscheiden (zum Beispiel rot für Moderation, grün für Beitritte).

Protokollkategorien

Netrcol gruppiert seine 55 Ereignistypen in diese 18 Kategorien:

Kategorie	Was sie protokolliert
Bot	Bot-Interaktionen und Protokolle zum Lebenszyklus der Gilde
Moderation	Protokolle zu Sperrungen, Entsperrungen, Automod und Mitarbeiteraktionen
Nachricht	Protokolle zu gelesenen Nachrichten, Löschungen, Bearbeitungen und Massenlöschungen
Reaktion	Emoji-Hinzufügung und -Entfernung
Mitglied	Beitritte, Abgänge, Rollenaktualisierungen, Namensänderungen und Zeitüberschreitungen
Kanal	Protokolle zu Kanalerstellungen, -löschungen, -umbenennungen, -themen und -kategorieänderungen
Rolle	Protokolle zu Rollen-Erstellungen, -aktualisierungen und -löschungen
Voice	Änderungen des Sprachstatus (Debug-Sprachereignisse erfordern ein Opt-in-Flag)
Einladung	Protokolle zu Einladungen, die erstellt und gelöscht werden
Server	Protokolle zu Servereinstellungen, Namen und Strukturänderungen
Asset	Protokolle zu Emoji- und Stickeraktualisierungen
Webhook	Ereignisse zur Aktualisierung von Webhooks
Sicherheit	Protokolle zu riskanten Aktivitäten und Schutzsystemen
Integration	Ereignisse zur Aktualisierung von Gildenintegrationen
Geplantes Ereignis	Protokolle zu geplanten Ereignissen, die erstellt, aktualisiert und gelöscht werden
Festgeheftete Nachricht	Protokolle zur Aktualisierung von Kanal-Pins
Präsenz	Protokolle zu Tipp- und Präsenzaktivitäten (Opt-in, hohes Volumen)
Benutzer	Änderungen am Benutzerprofil, die einmal pro betroffener Gilde angezeigt werden

Smarte Titel

Einige Kategorien verwenden klarere, spezifischere Titel anstelle eines generischen „Aktualisiert.“ Abgänge von Mitgliedern versuchen beispielsweise, verlassen, gekickt und gesperrt zu trennen; Änderungen an Einzelkanälen verwenden einen präzisen Titel wie „Kanalthema geändert“ anstelle von „Kanal aktualisiert.“

Audit-bewusste Anreicherung

Wenn Server-Audit-Protokolle verfügbar sind, werden Moderation- und Mitglied-Protokolle mit dem Akteur und dem Auditgrund angereichert – sodass ein Sperrprotokoll zeigen kann, *wer* es ausgesprochen hat und *warum*, nicht nur, dass es passiert ist.

Schnelle Einrichtung über den Chat

Wenn Sie alles in einem Kanal haben möchten, ohne das Dashboard zu öffnen:

!logs-setup 123456789012345678

Dies aktiviert alle 18 Kategorien und verweist sie auf diesen Kanal. Deaktivieren Sie das gesamte System mit:

!logs-disable

Vollständige Details finden Sie auf der Seite Protokollbefehle.

Hinweise & Tipps

Nichts ist standardmäßig aktiviert. Sie wählen aus, welche Kategorien verfolgt werden – beginnen Sie klein und fügen Sie nach Bedarf mehr hinzu.
Hochvolumige Kategorien. *Präsenz* (Tippen/Präsenz) ist standardmäßig deaktiviert und sollte am besten deaktiviert bleiben, es sei denn, Sie debuggen; es erfordert auch ein Bot-Umgebungs-Flag, um irgendetwas auszugeben.
Debug-Sprachereignisse bleiben stumm, es sei denn, ein globales Opt-in-Flag ist in der Bot-Umgebung aktiviert.
Deduplizierte Benutzerprotokolle. Eine einzelne Profiländerung wird pro Gilde gruppiert, selbst wenn mehrere zwischengespeicherte Nachrichten mit diesem Benutzer übereinstimmen, sodass Sie keine doppelten Einträge erhalten.
Nachrichtenspeicher. Um gelöschte/bearbeitete Inhalte anzuzeigen, hält Netrcol einen kurzen In-Memory-Cache von aktuellen Nachrichten pro Server. Es wird niemals in den permanenten Speicher geschrieben – siehe die Datenschutzrichtlinie.

Nächste Schritte

Konfigurieren Sie es unter Dashboard → Protokolle
Überprüfen Sie die Protokollbefehle
Stellen Sie sicher, dass Netrcol die richtigen Berechtigungen hat