Event Logging

Keep track of everything happening in your server with comprehensive event logging. Monitor moderation actions, member activity, and server changes.

Overview

Natsumi's logging system records important server events and sends detailed logs to designated channels. This helps moderators stay informed and provides an audit trail for server activity.

• Multiple log channel support
• Customizable event filters
• Rich embed formatting
• Moderation action tracking
• Message content logging
• Channel and user ignore lists, global or per event

Log Channels

You can set up different channels for different types of logs, keeping things organized and easy to monitor.

Mod Log

Moderation actions like warns, kicks, bans, and timeouts.

/moderation modlog setup channel:#mod-logs

Message Log

Deleted and edited messages with content.

/moderation modlog channel category:messages target:#message-logs

Member Log

Joins, leaves, role changes, and nickname updates.

/moderation modlog channel category:members target:#member-logs

Server Log

Channel, role, and server setting changes.

/moderation modlog channel category:server target:#server-logs

Voice Log

Voice channel joins, leaves, and moves.

/moderation modlog channel category:voice target:#voice-logs

Event Types

Natsumi can log the following types of events:

Moderation

• Member warned
• Member kicked
• Member banned
• Member unbanned
• Member timed out
• Automod violations

Messages

• Message deleted
• Message edited
• Bulk messages deleted
• Attachments logged

Members

• Member joined
• Member left
• Roles added/removed

Server

• Channel created
• Channel deleted
• Channel updated
• Role created
• Role deleted
• Role updated
• Emoji changes
• Server settings changed

Voice

• Joined voice channel
• Left voice channel
• Moved between channels
• Muted/Deafened

Invites

• Invite created
• Invite deleted
• Invite used (with tracker)

Configuration

Customize what gets logged and where:

Ignoring Channels

Nothing that happens in an ignored channel is logged. Ignoring a category covers every channel inside it, and ignoring a channel also covers its threads.

Ignore Channel

/moderation modlog ignore action:add channel:#channel

Ignoring Users

Nothing an ignored user does is logged, including the actions they take as a moderator.

Ignore User

/moderation modlog ignore action:add user:@user

Per-Event Ignores

Ignores are global by default and apply to every event. Add a category and event to limit an ignore to that one event, which stacks on top of the global lists. Use action:remove to take an entry back off a list, action:clear to empty both lists, and action:list to see what is currently ignored.

Ignore a channel for one event only

/moderation modlog ignore action:add channel:#bot-spam category:message event:messageDelete

Enabling/Disabling Events

Toggle specific event types:

Toggle Event

/moderation modlog toggle category:<category> event:<event> enabled:<true|false>

Pro Tip

Use the dashboard for an easier way to configure logging settings with a visual interface.

All Logging Commands

Command	Description
/moderation modlog setup	Set the main modlog channel
/moderation modlog channel	Send one event category to its own channel
/moderation modlog toggle	Enable or disable a specific event
/moderation modlog ignore action:add	Ignore a channel or user, globally or for one event
/moderation modlog ignore action:remove	Take a channel or user back off an ignore list
/moderation modlog ignore action:list	View the current ignore lists
/moderation modlog list	View all available events and the current configuration