Tutorials3 min read

Set Up a Discord Audit Log — 24 Events Live in Your Channels | TeraOne 2026

24 Discord events in 3 categories streamed live to your log channels — message edits, joins, role changes, voice. With actor resolution from Discord's audit API.

Audit Log: Every event. With actor. In your own log channel

Who gave out that role? Who deleted that channel? With the audit-log module 24 Discord events stream live into your log channels — including actor attribution from Discord's own audit API.

What it does

  • 24 events in 3 categories:
    • Messages (3): edit, delete, InviteCreate.
    • Members (12): join, leave, ban, unban, mute/unmute, nickname, avatar, role changes, voice join/leave/move.
    • Server (9): role + channel create/update/delete, guild-update, emojis.
  • Toggle each event individually — only want bans and joins? Disable the other 22 in one click.
  • Category-specific log channels#message-log, #member-log, #server-log — or pile them all into one.
  • Global ignore channels (up to 100) — exclude public voice channels from voice log, exclude admin channels from edit log.
  • Actor resolution from Discord audit — TeraOne queries Discord's audit API and shows the moderator name in the embed.
  • Optionally hide bot actions — default on: actions by bots are not logged.

How to set it up

  1. Open Dashboard → Moderation → Audit Log.
  2. Enable the module.
  3. Assign a log channel per category — the bot needs Send Messages, Embed Links and View Audit Log there.
  4. Toggle events individually — typical defaults: all 12 member events on, voice join/leave off, all server events on.
  5. Optionally set ignore channels.
  6. Save.

More on the feature overview.

Tips for better results

  • Only enable voice join/leave on small servers — on >5000-member servers it gets very noisy. Log voice-move/move only.
  • Exclude admin channels from edit log — sensitive channels (private mod discussions) do not belong in a public log.
  • Grant View Audit Log permission — without it, every entry says "unknown actor" because TeraOne cannot query Discord's audit API.

FAQ

Can I export historical logs? Not from TeraOne — the logs live in your Discord channels. Use Discord's copy feature or tools like DiscordChatExporter. We deliberately don't store them twice.

Why does "unknown actor" show up sometimes? Discord's audit log has ~45 days of retention and doesn't attribute every event (e.g. nickname self-change). Where Discord itself doesn't attribute, we can't either. The bot also needs View Audit Log.

How many events can I enable without rate-limit issues? All 24. The rate-limit guard only kicks in on bursts to a specific channel — rarely-firing events don't count toward the 10/10s burst.


Need help? Join our Discord server.