Logs Configuration

Configure comprehensive logging of your server events to keep track of everything that happens. Logs help you monitor activity, investigate incidents, and maintain transparency.

Access: Dashboard → Systems → Logs

What are Logs?

Logs automatically record important server events and send them to dedicated Discord channels. These logs are not stored by Marsha - they are sent in real-time to Discord channels you configure, following Discord's message retention policies.

Recordable events:

Member arrivals and departures, member modifications (nickname, roles), message deletions and edits, moderation actions (warns, bans, etc.), server changes (channels, roles), voice activity, and auto-moderation actions.

Log Categories

Member Logs

Member Join:

Records when a new member joins. Shows name, ID, account creation date, and avatar.

Member Leave:

Records when a member leaves or is kicked. Shows how they left (voluntary, kick, ban).

Member Update:

Records nickname changes, role additions/removals, and avatar or username changes.

Message Logs

Message Deleted:

Records when a message is deleted. Shows author, content, channel, and who deleted it (if moderator).

Message Edited:

Records when a message is edited. Shows before and after content.

Bulk Delete:

Records uses of /clear or bulk deletions. Shows how many messages were deleted and by whom.

Moderation Logs

Infractions:

Records all moderation actions (warns, mutes, kicks, bans). Shows member, moderator, sanction type, and reason.

Auto-Moderation:

Records auto-moderation rule triggers. Shows which rule triggered, action taken, and offending message.

Server Logs

Channels:

Records channel creation, deletion, and modification. Shows permission changes, name, topic, etc.

Roles:

Records role creation, deletion, and modification. Shows permission changes, color, name, etc.

Voice Logs

Voice Join/Leave:

Records when members join or leave voice channels.

Voice Move:

Records when members are moved between voice channels.

Mute/Deafen:

Records when members are muted or deafened in voice.

Configuring Logs

Step 1: Create Log Channels

Create private Discord channels to receive logs. Examples: #logs-moderation, #logs-messages, #logs-members.

Step 2: Enable Events

On the dashboard, go to Systems → Logs. For each event category, check "Enable" and select the channel to send logs to.

Step 3: Customize

Choose message format (embed or text), exclude certain channels or roles if necessary, and enable/disable specific events.

Filters and Exceptions

Exclude channels:

Don't record activity from certain channels (e.g., #spam, #bots).

Exclude roles:

Don't record actions from certain roles (e.g., bots, staff).

Ignore bots:

Global option to ignore all bot activity in logs.

Log Format

Embed Format (recommended):

Rich messages with colors, organized fields, and avatars. Prettier and more readable.

Text Format:

Simple text messages. More compact, better for log archiving.

Next Steps

• Auto-Moderation: Log auto-mod actions
• Settings: Configure role group exclusions
• Anti-Raid: Log anti-raid activations

Important

Logs are sent to Discord channels you configure and follow Discord's retention policies. Marsha does not store your logs on external servers.