Analytics & Operations
Monitor your community's health and manage day-to-day operations.
Stats Dashboard
Use /stats to get a snapshot of your server's health. The period option controls the time window:
| Option | Description |
|---|---|
period:week | Last 7 days |
period:month | Last 30 days |
period:all | All-time data |
The dashboard displays:
- Active users — unique members who participated in at least one event
- Rewards distributed — total RSNC paid out in the period
- Top events — highest-traffic reward triggers
- Engagement trends — day-over-day or week-over-week activity curves
Run /stats period:week each morning to catch overnight anomalies before your community wakes up.
Audit Log
/audit gives you a full transaction history for every reward event on the server.
Filter by user:
/audit user:@someone
Filter by event type:
/audit event:daily_checkin
Export to file:
/audit export:true
The export produces a structured file you can open in any spreadsheet tool. Archive it regularly — see the Daily Operations Checklist below.
KPI Tracking
Set numeric targets for the metrics that matter most to your community, then let Resonance alert you when things drift off course.
Setting a KPI
/kpi set metric:daily_active_users target:100 period:week
Viewing KPIs
/kpi view
Available Metrics
| Metric | Description |
|---|---|
daily_active_users | Unique users active per day |
weekly_active_users | Unique users active per week |
streak_retention | % of users maintaining streaks |
churn_rate | % of users who stopped participating |
avg_rewards_per_user | Average RSNC earned per active user |
voice_participation | Users active in voice channels |
Alerts
/kpi alerts
Get notified when a KPI misses its target. Alerts have three severity levels:
- critical — immediate attention required
- warning — trending in the wrong direction
- info — minor deviation, worth monitoring
Queue Management
New. When reward distribution encounters issues — API timeouts, rate limits, or processing errors — items pile up in the queue. These three commands give you visibility and control.
/queue status
View all pending, processing, and failed distributions. The response shows:
- Count of items in each state
- Age of the oldest pending item
- Recent failure details (error type, affected user, timestamp)
/queue retry
Reprocess all failed distributions. Items move back to pending and enter the next processing cycle. Run this after the underlying issue has been resolved.
/queue unstick
Reset items stuck in the processing state. Items can get stranded there if a worker times out mid-run — they hold the processing status indefinitely and block the queue from moving forward.
- Status — Check daily or whenever users report missing rewards
- Retry — After fixing the root cause (e.g., the external API is back up, rate limit has cleared)
- Unstick — When
/queue statusshows items that have been inprocessingfor more than 10 minutes
Reports
Schedule automated reports delivered directly to an admin channel:
/reports schedule type:weekly channel:#admin-reports
Resonance will post the report on a recurring basis so your team stays informed without having to pull data manually.
User Segments
/segments list
Resonance automatically segments your members based on behavior. Use these to target re-engagement campaigns, identify moderation candidates, or reward your most loyal contributors.
| Segment | Description | Suggested Action |
|---|---|---|
whales | Top 5% by rewards earned | Reward loyalty, offer exclusive perks |
power_users | Active daily, high engagement | Potential moderators |
new_users | Joined in the last 7 days | Welcome message, guide to earning |
at_risk | Declining activity | Re-engage with drops or events |
dormant | Inactive 30+ days | Win-back campaign |
voice_regulars | Frequent voice channel participants | Voice-specific rewards |
Watch the at_risk segment week over week — a sudden spike usually signals a content or event problem worth investigating.
Data Export
/export type:csv
Available export types:
| Type | Contents |
|---|---|
users | Member list with reward totals and segment labels |
rewards | Full reward transaction history |
events | Event definitions and trigger counts |
audit | Complete audit trail (same as /audit export:true) |
Exports are delivered as a file attachment in the channel where you run the command.
Daily Operations Checklist
A condensed routine to keep your server running smoothly.
Morning
-
/stats— check overnight activity for anomalies -
/queue status— verify no distributions are stuck or failing
Weekly
-
/kpi view— review all targets and note any misses -
/segments list— check whether theat_risksegment is growing -
/audit export:true— archive the transaction log for the week
Monthly
- Review reward amounts relative to overall engagement levels
- Adjust event thresholds based on quality and participation trends
-
/export type:users— pull a full user export for deeper analysis