Audit Logger

Audit Logger records server changes that matter to moderators and operators, including channels, roles, member activity, nickname updates, and voice channel joins/leaves.

What It Does

  • Logs channel creation, deletion, name changes, and permission updates
  • Logs role creation, deletion, name changes, mentionability, and permission updates
  • Logs member join/leave and role update events in a dedicated member audit channel
  • Logs member account detail updates (username, display name, primary server tag, and optionally avatar changes) to a separate member details audit channel when configured
  • Logs reactions added and removed with user, message, and timestamp details
  • Logs member voice channel join/leave/move events in a dedicated voice audit channel
  • Shows detailed changed permissions for role permission updates and channel overwrite changes
  • Uses event-specific channel or thread destinations for channel, role, member, member details, and voice audit logs when configured
  • Falls back to the general audit log channel or thread if no specific destination is set
  • Falls back to the global server log channel if no audit destination is configured
  • If no valid audit destination exists, the event category is disabled and a notice is sent to the global log or system channel
  • Supports excluded channels and roles to reduce noise

Setup

Configure the Audit Logger settings via:

/audit config

or through the universal config system:

/config cog AuditLogger

Minimum setup:

  1. Enable Audit Logger Enabled.
  2. Set Fallback Audit Log Channel.
  3. Optionally set event-specific channels or threads for channel, role, or member audit logs.
  4. Optionally disable event categories you do not want logged.
  5. Give the bot Send Messages permission in the configured audit destination.

Key Config Options

Setting Purpose
Audit Logger Enabled Master on/off switch for audit logging
Fallback Audit Log Channel Fallback channel or thread where audit event embeds are posted if event-specific destination is not set
Channel Audit Log Channel Channel or thread where channel-related audit events are posted
Role Audit Log Channel Channel or thread where role-related audit events are posted
Member Audit Log Channel Channel or thread where member join/leave/role update events are posted
Member Details Audit Log Channel Channel or thread where member detail changes (username, display name, server tag, and optionally avatar updates) are posted
Member Details Avatar Changes Toggle whether member avatar updates are included in member details audit logs
Reaction Audit Log Channel Channel or thread where reaction add/remove events are posted
Audit VC Roles Roles allowed to use /audit vcactivity to lookup recent VC activity
Member Voice Audit Channel Channel or thread where member voice join/leave/move events are posted
Member Details Events Log member detail changes such as username, display name, server tag, and optionally avatar changes
Reaction Events Log reaction adds and removes in the configured reaction audit channel
Channel Events Log channel create/update/delete events
Role Events Log role create/update/delete events
Member Events Log member join/leave and nickname change events
Member Voice Channel Events Enable tracking of member voice channel joins, leaves, and moves
Excluded Channels Channels excluded from channel audit logging
Excluded Roles Roles excluded from member audit logging

Commands

Command Description
/audit config Open the Audit Logger configuration interface
/audit vcactivity <user> Lookup recent VC join/leave/move events for a user from the configured VC audit log channel
/audit help Show Audit Logger help and quick usage info

How It Works

  • The cog listens for guild audit events and sends structured embeds to the configured audit channel.
  • Event-specific channel, role, and member audit channels are used when configured.
  • If audit_log_channel is configured and no event-specific channel or thread is present, it will be used as a fallback.
  • If no valid audit destination exists, the affected event category is disabled and a notice is sent to the global log or system channel.
  • Channel overwrite changes and role permission changes are logged with detailed permission-level differences.
  • Member events are ignored when the member has a role listed under Excluded Roles.

Notes

  • The audit logger is designed to complement, not replace, Discord’s built-in server audit log.
  • This cog is especially useful for servers without audit log access or for quickly surfacing changes to moderators in a channel.
  • For detailed moderation action logs, use the Moderation cog.