Reports
A guide to every report available in the Dicolytics dashboard, organized by sidebar category.
Interactions
Reports that analyze user-initiated actions sent to your bot. Data comes from the 6 interaction types.
Summary
A high-level view of all interaction activity. Displays total interaction count, breakdown by type (slash, button, select, modal, context menu, autocomplete), and a time-series trend chart. Use this to quickly assess overall bot engagement.
Commands
Ranking table of slash commands by usage count. Shows commandName (with full subcommand paths), total invocations, unique users, success rate, and average latency. Sort by any column to find your most popular or slowest commands.
Buttons
Usage statistics for button interactions, grouped by normalized customId. Snowflake IDs in custom IDs are replaced with {id} for grouping. See Interactions -- commandName field for details on normalization.
Selects
Usage statistics for select menu interactions (string selects, user selects, role selects, channel selects, mentionable selects), grouped by normalized customId.
Modals
Usage statistics for modal submit interactions, grouped by normalized customId.
Context Menus
Usage statistics for context menu commands (user commands and message commands), grouped by commandName.
Autocomplete
Count of autocomplete interactions per command. Since autocomplete has no response lifecycle, only invocation counts are available.
Heatmap
A time-of-day heatmap showing when interactions peak. The horizontal axis represents hours (0--23), and the vertical axis represents days of the week. Cell color intensity indicates interaction volume. Useful for identifying peak usage hours and planning maintenance windows.
Users
Reports that analyze user activity across your bot.
User List
A searchable, sortable table of all users who have interacted with the bot. Columns include user ID, total interactions, last active date, and top commands used.
Active Users
DAU (daily active users), WAU (weekly active users), and MAU (monthly active users) trends over time. Uses HLL-based approximate distinct counting. See Metrics & Dimensions -- HLL for details on the counting method.
Retention
User retention cohort analysis. Shows what percentage of users who first interacted in a given week returned in subsequent weeks. Useful for measuring long-term engagement.
Servers
Reports that analyze server (guild) activity and growth.
Server List
A searchable table of all servers where the bot is installed. Columns include server name, member count, interaction count, and join date.
Growth
Net server count over time, with guild joins and leaves shown as stacked bars. The line chart shows the cumulative server count.
Distribution
Server distribution by size (member count ranges). Shows how many of your bot's servers fall into each size bucket (e.g., 1--100 members, 100--1,000, 1,000--10,000, 10,000+).
Active Servers
Servers ranked by interaction volume. Helps identify your most engaged communities.
Regions
Server distribution by locale/region. Based on the locale field from guild_snapshot events.
Stability
Reports that analyze errors and response performance.
Errors
Error trend chart and error ranking table. Groups errors by name and message, with counts, first/last occurrence, and affected commands. Both command_error (auto-captured reply failures) and error (from captureError() and unhandled rejections) are included.
Latency
Response latency analysis for interactions. Shows average and p95 latency trends over time, latency distribution histogram, and per-command latency rankings. Tracks both total latencyMs and deferMs for deferred interactions.
Activity
Reports that analyze non-interaction bot activity.
Voice
Voice session statistics. Shows session count, total duration, average duration, and peak listener counts. Data comes from the action_voice_session event type.
Messages
Outbound message volume over time. Tracks action_message_send events (bot-sent messages). No message content is ever recorded -- only send counts.
Custom Events
Custom event activity from track() calls. Shows event counts grouped by data.name, with trend charts and property breakdowns. See Custom Events for how to send custom events.
Votes
Vote counts collected automatically from bot listing platforms (Koreanbots, Top.gg) every 10 minutes. Requires the Discord Application ID in project settings; no SDK code is needed.
Common Features
All reports share these features:
Date Range Picker
Select a time period for the data. Options: Today, Yesterday, Last 7/30/90 days, or a custom date range. Changing the period refreshes all data on the page.
Filters
Each page has a filter builder with dimensions relevant to that specific page. For example, the Commands page lets you filter by command, guild_id, and user_id.
Bookmarks
Save the current configuration (period, filters, sort order) as a bookmark for quick access later. Bookmarks appear in the sidebar under the page name.
Note
All state is serialized into the URL. Copy and share the URL to give teammates the exact same view.