Logging System

Squint's logging system tracks various events in your server, providing a detailed audit trail for moderation, member activity, and server changes. Logs are sent to a designated channel.

Quick Start (5 Minutes)

1. Run ;logs channel #mod-logs

2. Enable the logging system: ;logs enable

3. Check status: ;logs status

4. Test the logger: ;logs test

You're done! Read full setup below for advanced options.

Setup

1. Set a default logging channel: ;logs channel #your-log-channel

2. Enable the logging system: ;logs enable

3. (Optional) Configure specific event categories: ;logs events messages

4. (Optional) Set category-specific channels: ;logs categorychannel members #member-logs

5. Test the logging system: ;logs test

Configuration

• channel: The default channel where all logs are sent if no category-specific channel is set.

• categoryChannels: A map of event categories to specific channel IDs. For example, {"members": "123456789"}.

• events: A map of event categories to a boolean value, enabling or disabling logging for that category. For example, {"messages": true}.

• ignoredChannels: A list of channel IDs where logging should be ignored.

• ignoredUsers: A list of user IDs whose actions should be ignored by the logger.

Common Issues:

• Logs are not appearing → Ensure the bot has View Channel, Send Messages, and Embed Links permissions in the log channel.

• Logs are incomplete → Check that the bot has View Audit Log permission for moderation and server events.

• Too many logs are generated → Use ;logs events <category> to disable specific categories like messages or voice.

• Logs are sent to the wrong channel → Use ;logs categorychannel <category> reset to revert a category back to the default channel.

Usage

After setup, Squint will automatically send log entries to your configured channel(s) whenever a tracked event occurs. You can view a list of all available event categories using ;logs events.

Related Commands

• ;logs - Main command for managing logging settings.

• ;modlogs - View moderation-specific log entries.