Logging Dashboard UI Guide
Overview
The Logging Dashboard provides comprehensive control over your server's logging infrastructure. Configure which events get logged, where they're logged, how they're formatted, and easily search through historical logs with powerful filtering and date range selection.
Channel Configuration
Route different types of logs to dedicated channels for better organization. Each log channel can be configured independently, or you can consolidate logs to a single channel.
Main Log Channel
Default destination for general server events. This is the fallback channel when specific event types don't have their own channel configured.
Uses SearchableSelect channel picker for instant channel lookup and selection.
Mod-Action Channel
Dedicated channel for moderator actions: bans, kicks, mutes, warnings, timeouts, and role changes performed by staff members.
All mod actions are timestamped and include the responsible moderator.
Member Channel
Logs member join and leave events. Automatically timestamps when users enter and exit your server.
Tracks account creation date and previous server activity for new members.
Message Channel
Captures message edits and deletions. Preserves the original content before modifications for audit purposes.
Bulk deletes are grouped together for easier analysis.
Voice Channel
Logs voice state changes: connections, disconnections, channel switches, and mute/deafen state changes.
Tracks voice time spent in each channel for analytics.
Role Channel
Dedicated channel for role-related changes: role assignments, removals, and permission modifications.
Tracks both user role changes and server-wide role edits.
Configuration Tip
You can set all channels to the same destination or use dedicated channels for each log type. Use dedicated channels to reduce noise in your main logs while keeping everything organized.
Log Type Configuration
Enable or disable specific event types independently. Use toggles to control which events are captured without touching your channel routing.
Member Events
Toggle member join and member leave events. When enabled, the system logs when users enter or leave your server with timestamps.
Message Events
Toggle message edit and message delete events. Captures the full original message content and displays what changed.
Role Changes
Toggle role assignment and removal events. Logs when users receive or lose roles, and who triggered the change.
Channel Changes
Toggle channel creation, deletion, and edit events. Captures configuration changes including name, topic, and permissions.
Voice State
Toggle voice connection events. Logs when users connect to voice channels, switch channels, or disconnect.
Nickname Changes
Toggle nickname update events. Tracks when users change their display names with old and new values.
Ban/Unban Events
Toggle ban and unban events. Logs who banned/unbanned the user, when it happened, and the reason if provided.
Best Practice
Enable all log types when first setting up logging, then disable events you don't need after observing the log volume. This ensures you don't miss important events.
Log Filter Configuration
Reduce noise by filtering out logs from specific channels, roles, or bot accounts. Filters apply to all log types.
Exclude Channels
Select channels that should not generate logs. Use SearchableSelect to quickly find and exclude channels.
Common exclusions: announcements, bots-spam, or temporary voice channels.
Exclude Roles
Prevent logs for specific roles using SearchableSelect. Useful for filtering out bot activity or automated events.
Filter bot activity from your moderation logs while still tracking staff actions.
Exclude Bots Toggle
When enabled, all bot account actions are excluded from logs. Useful to keep logs focused on user activity.
Storage Impact
Filters reduce the volume of logs stored, which can help with storage limits and log search performance on large servers.
Log Format Options
Choose how logs are displayed in your log channels. Different formats suit different use cases.
Compact Format
Brief one-line or short embeds showing essential information only. Ideal for high-volume logging scenarios where you want to scan logs quickly.
Detailed Format
Full embeds with all available information, timestamps, user avatars, and detailed change descriptions. Better for archival and detailed audits.
Custom Embed Colors
Configure color schemes for different event types. Color-coding helps visually differentiate log categories at a glance.
Color Coding Suggestion
Use red for moderation actions, yellow for warnings, green for member joins, blue for message edits, and purple for role changes.
Log Search Interface
Powerful search and filtering tools to find specific logs quickly. Perfect for investigations and compliance audits.
Date Range Picker
Select custom date ranges or quick options (last 24h, 7 days, 30 days). Essential for time-based investigations.
User Filter
SearchableSelect dropdown to filter logs by specific user. See all activity related to one member across all log types.
Supports filtering by username, user ID, or Discord handle.
Event Type Filter
SearchableSelect to narrow results to specific event types (member join, message delete, role change, etc.).
Combine multiple filters for precise searches.
Keyword Search
Full-text search across log content. Find specific message text, reasons, or any keywords in log entries.
Channel Filter
SearchableSelect to filter logs by the channel where the action occurred.
Search Tips
Combine multiple filters for powerful searches. For example, filter by user + event type + date range to find exactly what you need.
Use keyword search to find specific message content or ban reasons across all logs.
Implementation Notes
Key technical details about the logging system's behavior and integration points.
Dropdown Implementation
All channel, role, user, and event type selectors use SearchableSelect components. This provides:
- • Typeable search for quick filtering
- • Autocomplete as you type
- • Keyboard navigation support
- • Multi-select for filters with multiple options
Data Retention
Logs are retained based on your server plan. Higher tier plans include longer retention periods. Use the search interface to access historical logs efficiently.
Moderation Workflow
Configure the mod-action channel to alert your moderation team. Set up role exclusions and channel filters to ensure logs remain relevant and manageable.
Best Practices
Recommended Setup
- • Create dedicated channels for different log types to reduce noise
- • Enable bot filtering to exclude automated events from your logs
- • Use detailed format for mod-action logs, compact for high-volume events
- • Regularly review logs using the search interface for compliance
- • Set up alerts for ban/unban events using the filtering system