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 joins, leaves, nickname changes, and voice channel join/leave/move events
  • Shows detailed changed permissions for role permission updates and channel overwrite changes
  • Uses event-specific channel or thread destinations for channel, role, member, 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/nickname audit events are posted
Member Voice Audit Channel Channel or thread where member voice join/leave/move events are posted
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 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.