Dashboard Overview
The Dicolytics dashboard is a web interface for viewing all bot analytics in one place, with KPI cards, trend charts, and detailed reports.
Home Screen
After signing in with Discord and selecting a project, the Overview screen appears.
Before SDK Connection
If the SDK has not sent any events yet, an onboarding card guides you through installation:
- Install the SDK package
- Add the API key to your bot code
- Start the bot and wait for the first heartbeat
The card's steps turn green as each milestone is detected. See Getting Started to complete the setup.
After SDK Connection
Once events are flowing, the home screen displays a widget grid with six KPI tabs:
| KPI Tab | Metric | Description |
|---|---|---|
| Total Events | events | Total event rows received in the selected period |
| Interactions | interactions | Interaction count across all 6 types |
| Active Users | unique_users | Approximate distinct user count (HLL) |
| Server Growth | Guild join - leave delta | Net server count change |
| Errors | errors | Total error + command_error events |
| Status | Heartbeat recency | Bot online/offline indicator |
Each KPI card includes:
- Current value for the selected period
- Comparison with the previous period of equal length (e.g., this week vs. last week), shown as a percentage change
- Sparkline showing the trend across the period
Note
The comparison period is automatically computed. If you select "Last 7 days", the comparison is the 7 days before that. The percentage change helps you quickly identify upward or downward trends.
Bot Status Indicator
The status indicator on the home screen shows:
- Online (green) -- heartbeat received within the last 2 minutes
- Offline (red) -- no heartbeat for more than 2 minutes
- Never connected (gray) -- no heartbeat has ever been received
SDK Warning Banner
If the dashboard detects an outdated SDK version from the sdk.version field in event envelopes, a warning banner appears recommending an upgrade.
Report Navigation
The left sidebar organizes reports into five categories:
| Category | Reports |
|---|---|
| Interactions | Summary, Commands, Buttons, Selects, Modals, Context Menus, Autocomplete, Heatmap |
| Users | User List, Active Users, Retention |
| Servers | Server List, Growth, Distribution, Active Servers, Regions |
| Stability | Errors, Latency |
| Activity | Voice, Messages, Custom Events, Votes |
See Reports for a description of each report.
Period Selection
All report pages include a period picker in the top toolbar:
- Today -- midnight to now
- Yesterday -- previous full day
- Last 7 days / Last 30 days / Last 90 days
- Custom range -- pick specific start and end dates
Changing the period refreshes all KPIs, charts, and tables on the page.
Filtering
Each report page has a filter builder in the toolbar. Available filter dimensions vary by report (e.g., the Commands report lets you filter by command, guild_id, user_id).
Filter state is serialized into the URL, so filtered views can be shared by copying the URL. See Explore for the full list of filter operators.