Fjord

Fjord Dokumentation

Module

03

Aktivitätsprotokoll

Protokolliere wichtige Ereignisse übersichtlich in den von dir ausgewählten Discord-Kanälen.

Enthaltene Funktionen

  • 89 unterstützte Ereignistypen
  • Ein gemeinsamer Protokollkanal
  • Gezielt aktivierbare Protokolle

Was kann das Aktivitätsprotokoll?

Das Aktivitätsprotokoll hält ausgewählte Vorgänge auf deinem Server fest. Du wählst aus 89 Ereignistypen und legst einen Discord-Kanal für die Einträge fest. So kannst du beispielsweise Änderungen an Nachrichten und Moderationsvorgänge nachvollziehen.

Aktivitätsprotokoll einrichten

Der Schalter „Protokollierung“ aktiviert oder deaktiviert das Aktivitätsprotokoll, unabhängig davon, ob ein Kanal ausgewählt ist. Beim Ausschalten bleibt ein gewählter Protokollkanal erhalten. Wählst du „Kein Kanal“, wird der Schalter automatisch auf inaktiv gesetzt.

Aktivitätsprotokoll erfasst ausgewählte Vorgänge auf dem Server und veröffentlicht sie gesammelt in einem festgelegten Discord-Textkanal.

Benötigte Discord-Rechte

Kanal ansehen Webhooks verwalten Audit-Log anzeigen

„Kanal ansehen“ und „Webhooks verwalten“ müssen im gewählten Protokollkanal verfügbar sein. „Audit-Log anzeigen“ wird benötigt, damit Fjord administrative Vorgänge erfassen und ausführende Personen zuverlässig zuordnen kann. Kanalbezogene Berechtigungsüberschreibungen können ein serverweit erteiltes Kanalrecht außer Kraft setzen.

ProtokollierungOptional

Schaltet das gesamte Aktivitätsprotokoll ein oder aus. Ohne Aktivierung werden keine ausgewählten Ereignisse ausgegeben.

ProtokollkanalPflicht bei Aktivierung

Bestimmt den Textkanal, in dem die Einträge veröffentlicht werden. Der Kanal muss für Fjord erreichbar und beschreibbar sein.

EreignisseMindestens eines Pflicht

Jeder Ereignistyp kann einzeln aktiviert werden. Bei eingeschalteter Protokollierung muss mindestens ein Ereignis ausgewählt sein.

Bots einbeziehenOptional

Legt fest, ob auch Aktionen anderer Bots protokolliert werden.

  1. Öffne im Dashboard den gewünschten Server und anschließend Aktivitätsprotokoll.
  2. Aktiviere Protokollierung.
  3. Wähle einen Protokollkanal aus.
  4. Aktiviere mindestens eines der verfügbaren Ereignisse.
  5. Lege bei Bedarf fest, ob Aktionen anderer Bots einbezogen werden.
  6. Speichere die Konfiguration.

Zustellung über einen Webhook

Aktivitätsprotokoll veröffentlicht seine Einträge über einen Webhook. Die Einträge werden nicht als gewöhnliche Botnachrichten gesendet. Dafür benötigt Fjord im Protokollkanal die Berechtigung Webhooks verwalten.

VeröffentlichungAutomatisch

Erkannte Aktivitäten werden gesammelt und anschließend über den Webhook im gewählten Kanal veröffentlicht.

SammelintervallUngefähr 2 Minuten

Neue Einträge erscheinen nicht zwingend sofort. Fjord veröffentlicht die gesammelten Protokolle ungefähr alle zwei Minuten.

Eine Verzögerung von bis zu etwa zwei Minuten ist normal und bedeutet nicht, dass Aktivitätsprotokoll ausgefallen ist.

Ereignisse auswählen

Es stehen 89 einzeln aktivierbare Ereignistypen zur Verfügung. Das Suchfeld durchsucht ihre Namen und Beschreibungen. Nicht benötigte Ereignisse können ausgeschaltet bleiben, damit der Protokollkanal nur relevante Vorgänge enthält.

KategorieErfasste Vorgänge
NachrichtenBearbeitungen, einzelne und mehrfache Löschungen, Pins, Reaktionen sowie entfernte Links oder Anhänge.
Kanäle & BerechtigungenErstellung, Bearbeitung und Löschung von Kanälen sowie Änderungen an Kanalberechtigungen.
ThreadsErstellung, Bearbeitung und Löschung von Threads.
Rollen & RechteRollen, Rollenberechtigungen, Mitgliedsrollen und Änderungen der Rollenreihenfolge.
MitgliederBeitritt, Austritt, Kick, Ban, Entbannung, Profil, Nickname und Timeout.
Sprache & BühneBeitritt, Verlassen, Verschieben, Trennen, Stumm- oder Taubschalten, Stream, Kamera und Stage-Kanäle.
Server & BoostsServerprofil, Sicherheit, Community-Einstellungen, Eigentumsübertragung und Booststatus.
EinladungenErstellung, Bearbeitung und Löschung von Einladungen.
Apps & AutomatisierungBots, Integrationen, App-Befehlsrechte und Webhooks.
Emojis, Sticker & SoundsErstellung, Bearbeitung und Löschung von Emojis, Stickern und Soundboard-Sounds.
Events & CommunityServerevents, Onboarding-Fragen, Onboarding und Server Guide.
Auto-Moderator & ModerationMitgliederbereinigung, Regeln und Treffer des Auto-Moderators, Quarantäne, Timeouts, Verwarnungen sowie nicht zugeordnete Audit-Aktionen.
MonetarisierungUnterstützte Monetarisierungsanfragen und angenommene Bedingungen.

Es muss mindestens ein Ereignis eingeschaltet sein. Welche Auswahl sinnvoll ist, hängt davon ab, welche Vorgänge im Protokollkanal erscheinen sollen.

Botaktionen einbeziehen

Ist Bots einbeziehen deaktiviert, werden Aktionen anderer Bots nicht protokolliert. Das verhindert, dass automatische Abläufe den Protokollkanal unnötig füllen.

Ist die Einstellung aktiviert, können auch Änderungen durch Moderations-, Rollen- oder Integrationsbots erscheinen. Welche Arten von Aktionen ausgegeben werden, bestimmen weiterhin die ausgewählten Ereignisse.

Verfügbarkeit vorheriger Inhalte

Bei bearbeiteten oder gelöschten Nachrichten versucht Aktivitätsprotokoll, den vorherigen und den neuen Stand anzuzeigen. Der vorherige Inhalt ist jedoch nicht in jedem Fall verfügbar.

Fehlt ein vorheriger Inhalt, kennzeichnet Fjord ihn im Protokoll als nicht verfügbar. Alle noch vorhandenen Angaben werden trotzdem ausgegeben. Bei einer Bearbeitung kann deshalb beispielsweise der neue Inhalt erscheinen, obwohl der vorherige Inhalt fehlt.

Eine unvollständige Vorher-/Nachher-Darstellung bedeutet nicht, dass Aktivitätsprotokoll ausgefallen ist. Nachrichteninhalte werden aus Datenschutzgründen nicht unbegrenzt vorgehalten.

Fehler beheben

BeobachtungPrüfung
Ein Ereignis erscheint nicht sofort.Warte ungefähr zwei Minuten. Die Einträge werden vor der Veröffentlichung gesammelt.
Auch nach dem Sammelintervall erscheint nichts.Prüfe, ob Protokollierung und der passende Ereignistyp aktiviert sind und ob die Konfiguration gespeichert wurde.
Der Protokollkanal ist nicht auswählbar.Prüfe, ob Fjord den Kanal sehen und dort schreiben kann. Beachte auch kanalbezogene Berechtigungsüberschreibungen.
Der Webhook fehlt oder veröffentlicht nichts.Prüfe im Protokollkanal die Berechtigung Webhooks verwalten. Wähle den Kanal anschließend erneut aus und speichere.
Botaktionen fehlen.Aktiviere Bots einbeziehen und prüfe, ob der passende Ereignistyp eingeschaltet ist.
Der Kanal enthält zu viele Einträge.Deaktiviere nicht benötigte Ereignisse oder schließe Aktionen anderer Bots aus.
Vorheriger Nachrichteninhalt fehlt.Die Angabe konnte nicht bereitgestellt werden und wird deshalb als nicht verfügbar gekennzeichnet. Das ist kein Defekt.
Der gespeicherte Kanal ist nicht mehr verfügbar.Wähle einen bestehenden, für Fjord erreichbaren Textkanal und speichere erneut.