Browse documentation

VIRCON

Reports & Dashboards

ANALYTICS & INSIGHTS

Reports & Dashboards

VIRCON provides comprehensive reporting and real-time dashboards for moderation analytics, staff performance, risk assessment, and system health. Automated report generation keeps leadership informed while dashboards provide at-a-glance insights for daily operations.

Report & Dashboard Commands

Commands for generating analytics reports and refreshing dashboard metrics.

  • ,report moderation [days] - Moderation activity summary report
  • ,report risk [days] - High-risk user and trend analysis
  • ,report performance [@staff] [days] - Staff performance metrics
  • ,report list - View all available report types
  • ,report view <report_id> - View previously generated report
  • ,dashboard overview - View executive summary dashboard
  • ,dashboard analytics - Detailed analytics and charts
  • ,dashboard refresh - Regenerate all dashboard metrics

Report Types

Available report categories with generation frequency and intended audience.

Report TypeFrequencyAudience
Moderation Report
Bans, kicks, warnings breakdown with trends
Daily/Weekly/MonthlyAll Staff
Risk Report
High-risk users, escalation patterns, predictions
WeeklyAdmin+
Performance Report
Staff activity, response times, approval rates
Weekly/MonthlyHead Admin
Coverage Report
Shift tracking, gap analysis, availability metrics
WeeklyAdmin+
Incident Summary
Major incidents, resolutions, patterns
MonthlyAdmin+

Dashboard Metrics

Real-time metrics displayed on the executive dashboard for at-a-glance insights.

Total active staff and availability status
Moderation actions in last 24h/7d/30d
Current high-risk user count and trend
Pending appeals and handover notes
VRChat sync status and member count
Bot uptime and health indicators
Top 5 problem VRChat worlds this week
Staff leaderboard (actions, response time)
Anomaly alerts requiring review
Upcoming high-risk periods (predictions)

Report Generation Workflow

Step-by-step process from data querying through formatting to delivery.

  1. 1. Staff initiates report generation with command specifying type and timeframe.
  2. 2. System queries database for relevant metrics over specified period.
  3. 3. Data aggregated, calculated, and formatted into structured report.
  4. 4. Charts, tables, and trend graphs generated for visual clarity.
  5. 5. Report saved to reports database with unique ID for future reference.
  6. 6. Report posted to appropriate channel (admin/staff) based on sensitivity.
  7. 7. PDF/CSV export option available for external sharing or archival.

Report Database Schema

Database structure for storing generated reports and their metadata.

FieldDescription
report_idUnique report identifier.
report_typemoderation, risk, performance, coverage, incident.
generated_byDiscord ID of staff who requested report.
generated_atTimestamp of report generation.
time_period_startStart of analysis window.
time_period_endEnd of analysis window.
metrics_snapshotJSON object with all calculated metrics.
report_urlLink to formatted report (Discord message or file).
export_formatembed, pdf, csv.

Dashboard Components

Visual components and metric groupings on the executive dashboard.

Executive Summary

Total staff online
Actions last 24h
Pending items
System health

Activity Graphs

Hourly moderation heatmap
7-day trend line
Staff activity distribution

Risk Overview

High-risk user list
Escalation predictions
Pattern flags

Staff Leaderboard

Top 10 active staff
Response time averages
Approval rates

System Status

VRChat sync health
Database size
Backup status
Uptime

Automation Features

Scheduled report generation, auto-refresh cycles, and threshold-based alerting.

  • Daily moderation report auto-generated at 08:00 UTC and posted to staff channel.
  • Weekly risk report auto-generated Monday 09:00 UTC for admin review.
  • Monthly performance reports auto-generated 1st of month, sent via DM to head admin.
  • Dashboard auto-refreshes every 5 minutes for real-time metrics.
  • Critical metric thresholds trigger alerts (e.g., 10+ high-risk users).
  • Report archival: older than 90 days moved to cold storage (accessible on request).

Real-World Use Cases

Practical examples of reports and dashboards informing data-driven decisions.

Case 1

Head admin preparing for monthly staff meeting

Action: Generates performance report for last 30 days, exports to PDF

Outcome: Data-backed discussion on staffing needs and recognition

Case 2

Spike in moderation actions observed

Action: Views dashboard analytics to see hourly breakdown and world heatmap

Outcome: Identifies problematic VRChat world, increases monitoring

Case 3

Evaluating new moderator after probation

Action: Generates performance report for that specific staff member

Outcome: 90% approval rate shown, moderator graduated based on data

Best Practices

Guidelines for effective report usage and dashboard monitoring workflows.

  • Review daily moderation reports to catch trends early.
  • Use performance reports for constructive staff feedback, not punishment.
  • Generate custom reports before policy change discussions (data-driven).
  • Export monthly reports to PDF for leadership meetings or documentation.
  • Monitor dashboard before/during community events for real-time insights.
  • Cross-reference risk reports with incident reports for pattern validation.