Epix

Logging

Sixty events, where they go, and how to keep the output readable.

Logging records what happens in your server: messages edited and deleted, members joining and leaving, roles and channels changing, moderation actions taken. Every event can be turned on independently and sent wherever you want.

Routing

Events are grouped into fifteen categories, and each category can have its own destination channel. Splitting them is the difference between a log you read and a log you scroll past.

  • Message events are the highest volume by a wide margin. Give them their own channel.
  • Moderation events are the lowest volume and the most important. Give them their own channel too, and give your staff a reason to watch it.
  • Everything else can share a channel until it does not.

Webhooks

Logs are posted through a webhook rather than as bot messages. That is why Manage Webhooks is required, and it is what lets logging keep working across a restart.

Ignore lists

Channels, roles and members can be excluded per category. The usual first entries are the log channels themselves — a logger that logs its own output produces an interesting graph and an unusable channel.