Kaveh Appearance
Logging
This page is for admins. Kaveh can record what happens in your server (edits, deletes, joins, moderation actions and more) in channels you choose. By the end you'll have it set up and know it's reaching the right place.
Set it up
Run /setup logging, or open Logging in the dashboard. Start simple:
- Pick one default channel. Everything goes there at first.
- If your server is busy, give the noisiest kinds their own channels: message edits and deletes, joins and leaves, and moderation actions.
- Leave message content logging off unless your rules need it. With it off, Kaveh records that a message was deleted but not what it said.
What can be logged
| Kind | What it records |
|---|---|
| Mod actions | Warnings, timeouts, kicks, bans and automod actions |
| Message logs | Edited and deleted messages |
| Join and leave | Members joining and leaving |
| Server events | Role, channel and server changes |
| Modmail | A conversation opening, replies and closing |
| Starboard | Messages added to or removed from the starboard |
| Music | Playback events (optional) |
Anything without its own channel goes to the default one.
Layouts that work
- A small server: one log channel, and maybe a separate one for message logs if it gets noisy.
- A larger server: a default channel as the fallback, plus
#mod-actions,#message-logs,#join-leaveand#server-updates. Keep mod actions away from the high-volume message logs so staff don't miss them.
Make the log channels private to staff.
Check that it works
Do one of each: edit a message, delete one, run /mod warn on a test account, and have a test account join and leave. Each should show up in the channel you expect. Then run /setup status verify:true to catch a log channel that was deleted.
If nothing appears
- Run
/logging statusto see which channel each kind uses. - Kaveh needs to view and send messages in the log channel.
- Check that the kind is switched on with
/logging events, and try/logging test.
Look over your channels once a month. Restructuring a server often leaves a log pointing at a channel that no longer exists.