Logging
Track server events with comprehensive logging.
Logging#
Strelitzia logs server events into channels you choose, one channel per category. Set it up and pick exactly which events each category posts from the dashboard.
Categories#
| Category | What it logs |
|---|---|
| Member | Roles added and removed (including bulk role changes from the dashboard), nicknames, server avatars, usernames, display names, avatars, avatar decorations and server tags |
| Join / Leave | Joins, leaves and kicks, plus verification passes, failed attempts, flags and manual or bulk verification |
| Message | Deleted and edited messages, threads created, deleted and changed (name, archived, locked, tags), thread members, and reactions |
| Voice | Joins, leaves and moves between voice channels, and quick-voice channels being created |
| Stage | Stages starting and ending, topic changes, members becoming speakers or moving back to the audience, raised and lowered hands, and audience joins and leaves |
| Server | Channels created, deleted and changed (name, category, position, topic, NSFW, slowmode, bitrate, user limit, permissions), emojis added, removed and renamed, bans and unbans, and purges |
| Events | Scheduled events created, deleted, started, ended, canceled and changed, and members marking or removing interest |
| AutoMod | Rules triggered, rules created, deleted, enabled, disabled and edited, escalations applied or failed, and reply pings caught |
| Warnings | Warnings added and removed |
| Tickets | Tickets opened, claimed, members added, and tickets closed, with a link to the transcript |
| Forms | Submissions received, approved and denied |
Joins and leaves in a stage channel go to Stage logs, not Voice logs. Moving between a voice channel and a stage channel is logged in Voice as a move.
Choosing Events#
Each category's Settings lists its events grouped by kind, such as Avatar decoration under Member. Untick a kind to stop all of it, or expand it to choose single events, like logging decorations being added and changed but not removed. A kind with only some of its events on shows a partly filled checkbox.
When a single update changes several things at once, only the ticked parts are logged. If a member changes their avatar and removes their decoration in one edit, and decorations are unticked, the log shows just the avatar.
Events added in future updates start on, so you never miss a new kind of log without knowing it exists. The exceptions are noisy ones, which start off: reactions being added and removed.
Your choices only affect the log channels. User Monitor threads still get everything for the members they watch.
Reactions#
Reaction logs are part of the Message category. Reactions being added and removed are off by default, since busy servers react constantly. Turn them on in Message's Settings. To keep the channel readable, reactions on a message are collected for up to a minute and then posted as one summary listing each emoji and who used it.
Cleared reactions, when a moderator removes all reactions from a message or every reaction of one emoji, are on by default and logged straight away.
Ticket Transcripts#
When a ticket closes, its log links to the ticket's transcript on the dashboard. Full logs show a View transcript button and Minimal logs end with a Transcript link. Only staff with access to the server's tickets on the dashboard can open it.
Log Style#
Each category can post its logs in one of two styles:
- Full: a detailed embed for every event, with every field, the original embeds and any attachments.
- Minimal: one compact line per event. A colored tag such as ROLE, EDIT or DELETE, a short sentence, and the time. A second line shows the details when they matter, like an edit's before and after.
You choose a style for every category at once during setup, or one by one in each category's Settings, where a preview shows what each style looks like. Minimal message logs leave out attachments and list their file names instead.
Deleted and Edited Messages#
Message logs post a copy of each deleted message, including its text, embeds and attachments, and the text of an edited message before and after the edit. These copies live in your log channel, not on Strelitzia's servers, and stay until your staff delete them. Strelitzia keeps no copy of its own.
Copying a message from an age-restricted channel into a channel that isn't one would break Discord's rules on adult content. So when the message came from an age-restricted channel and your log channel isn't one, the log shows who and where but leaves out the text and files. To log those messages in full, make your message log channel age-restricted. Automatic setup does this for you when it creates the channel in a server that already has age-restricted channels. The same rule applies to AutoMod logs and to user monitor threads.
When Discord's own content scanning has flagged an image or file as explicit, gore or self-harm, the deleted-message log still includes it, but as a spoiler, so staff only see it if they click. Flagged images inside embeds are left out, since embed images can't be spoilered.
Setup#
- Go to the dashboard and select your server
- Open Audit Logs under Moderation in the sidebar
- Set up the log channels automatically, or turn on categories one at a time
- Open a category's Settings to change its channel, send a test log, pick its style and choose its events, then Save
Log Format#
Each log entry includes:
- Timestamp
- The user who performed the action, when Discord reports one
- Details of what changed
- Relevant IDs for audit purposes