Skip to main content

Server Logging

Audit Everything That Happens in Your Server

Overview

Server Logging posts human-readable entries to a configurable Discord channel whenever notable events occur in your server. Intended for your moderation team, not your members. Distinct from the internal Aether audit log — this module surfaces information directly inside Discord so staff don't need to leave the app.

Supports a single catch-all log channel or separate channels per event category (messages, members, server/role changes, voice). Every event type is individually toggleable, and specific channels or roles can be excluded from logging entirely.

Setup

  1. Open /settings and navigate to Server Logging.
  2. Enable the module.
  3. Choose a channel mode: single channel or per-category.
  4. Set your log channel(s).
  5. Review the event categories (Messages, Members, Roles, Channels, Voice, Invites, Server) and disable any events you don't need.
  6. Optionally configure ignored channels (message events in these channels will not be logged) and ignored roles (member action events from members holding these roles will not be logged).

Usage

Once configured, the bot automatically posts formatted embeds to the designated log channel(s) whenever a tracked event fires. No commands are required after initial setup.

Each embed includes relevant context (user, channel, before/after values, timestamps) and is color-coded by event type:

  • Green — join, create, unban
  • Red — leave, kick, ban, delete
  • Yellow — edits and updates
  • Purple — voice activity

Commands

Server Logging has no user-facing commands. All configuration is done through /settings → Server Logging.


Tracked Events

Messages

EventDescription
Message EditedBefore and after content of an edited message
Message DeletedContent and author of a deleted message
Bulk DeleteNumber of messages removed in a purge

Members

EventDescription
JoinUser joined the server, with account age
LeaveUser left the server voluntarily
KickUser was kicked (detected via audit log)
BanUser was banned
UnbanUser was unbanned
Nickname ChangeBefore and after nickname
Role AddedA role was granted to a member
Role RemovedA role was removed from a member
TimeoutTimeout applied or removed

Roles

EventDescription
Role CreatedA new role was created
Role DeletedA role was deleted
Role UpdatedName, color, or permissions changed

Channels

EventDescription
Channel CreatedA new channel or category was created
Channel DeletedA channel was deleted
Channel UpdatedName, topic, or slowmode changed

Voice

EventDescription
Voice JoinMember joined a voice channel
Voice LeaveMember left a voice channel
Voice MoveMember moved between voice channels

Invites

EventDescription
Invite CreatedNew invite created, with code and expiry
Invite DeletedInvite deleted or expired

Server

EventDescription
Server Name ChangedBefore and after server name
Icon ChangedNew server icon thumbnail
Verification Level ChangedBefore and after verification level

Configuration Reference

SettingDescription
EnabledMaster on/off for the module
Channel Modesingle — one channel for everything; category — separate channels per event type
Log ChannelTarget channel in single mode
Category ChannelsSeparate channels for messages, members, server, and voice events
Ignored ChannelsMessage events in these channels are suppressed
Ignored RolesMember action events from members holding these roles are suppressed
Per-event togglesEach of the 26 event types can be individually enabled or disabled