Logging

Log Filters

Control what gets logged by setting up filters to exclude specific channels, users, and types of events.

Overview

Log filters let you customize what gets logged on your server. You can exclude certain channels, users, or event types from being logged. This helps reduce noise in your log channels and focus on events that matter to your moderation team.

Filter Commands

CommandDescription
/logging ignore add channel <channel>Don't log events in this channel
/logging ignore remove channel <channel>Resume logging in this channel
/logging ignore add user <user>Don't log events from this user
/logging ignore remove user <user>Resume logging events from this user
/logging ignore add role <role>Don't log events from users with this role
/logging ignore remove role <role>Resume logging events from this role
/logging ignore listView all current filters
/logging ignore clearClear all filters

Filter Types

Channel Filters

Exclude specific channels from being logged.

Examples: Useful for test channels, bot channels, or high-traffic channels you don't need to monitor

/logging ignore add channel #bot-spam

User Filters

Prevent specific users' actions from being logged.

Examples: Good for bot accounts or special automated users that generate excessive logs

/logging ignore add user @BotUser

Role Filters

Exclude all actions from users with a specific role.

Examples: Useful for exempting staff actions or admin accounts from logging

/logging ignore add role @Administrators

Event Type Filters

Disable logging for specific types of events.

Examples: Skip logging low-priority events like voice channel changes

Configure via dashboard settings

Common Filter Scenarios

Exclude Bot Channels

Don't log messages in bot-only channels to reduce clutter

/logging ignore add channel #bot-commands/logging ignore add channel #api-testing

Exclude Admin Actions

Don't log routine admin and bot actions

/logging ignore add user @SYNTHET/logging ignore add role @Admin

Exclude High-Traffic Channels

Skip logging in very active channels to focus on important events

/logging ignore add channel #general/logging ignore add channel #memes

Monitor Only Staff Actions

Set up filters to log only moderation-related events

/logging channel mod #mod-logs/logging ignore add channel #announcements

Managing Your Filters

Keep your filters organized and up-to-date:

List Filters- Use /logging ignore list to see all active filters anytime
Review Regularly- Check your filters monthly to ensure they still make sense
Remove Old Filters- Clean up filters for users or channels that no longer exist
Test Changes- When adjusting filters, verify logging works as expected

What Gets Logged Despite Filters

Some critical events are always logged regardless of your filter settings:

  • • Moderation actions (warnings, mutes, kicks, bans)
  • • Member joins and leaves
  • • Role assignments and removals
  • • Server and channel configuration changes
  • • Security-related events

Best Practices

  • • Start with few filters and add more as you identify noise in your logs
  • • Never filter out moderation actions - these should always be logged
  • • Create separate log channels for different event types instead of filtering everything
  • • Document your filter settings so staff understand why certain events aren't logged
  • • Be cautious about filtering out member join/leave events as these are important for security
  • • Review filters quarterly to make sure they still align with your server needs
Log TypesSearch Logs