Logging

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.

/modlog set #mod-logs

Message Log

Deleted and edited messages with content.

/logging messages #message-logs

Member Log

Joins, leaves, role changes, and nickname updates.

/logging members #member-logs

Server Log

Channel, role, and server setting changes.

/logging server #server-logs

Voice Log

Voice channel joins, leaves, and moves.

/logging voice #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
/logging toggle <event-type>
Pro Tip

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

All Logging Commands

CommandDescription
/modlog setSet the mod log channel
/logging messagesSet message log channel
/logging membersSet member log channel
/logging serverSet server log channel
/logging voiceSet voice log channel
/moderation modlog ignore action:addIgnore a channel or user, globally or for one event
/moderation modlog ignore action:removeTake a channel or user back off an ignore list
/moderation modlog ignore action:listView the current ignore lists
/logging toggleToggle specific events
/logging statusView current logging config