ShadowConfigDocs

Community Health Dashboard

Monitor Discord server health, Roblox group growth, and live game telemetry in one place.

Overview

The Community Health Dashboard is a web dashboard that gives you a live view of how your game and community are performing. It combines Discord server metrics, Roblox group growth, and in-game telemetry into a single analytics surface. This feature is available on the Pro and Developer plans.

What it tracks

  • Discord health: member counts, active users, message volume, and bot command usage.
  • Roblox group growth: rank distribution, join trends, and role changes over time.
  • Game telemetry: server counts, player counts, crash signals, and performance warnings from the in-game setup script.
  • Revenue & monetization: all-time revenue, paying users, new vs returning users, total visits, and favorites via the Roblox Analytics Query API.
  • Performance & stability: client/server CPU time, FPS, memory usage, crash counts/rates, peak concurrent players, and average session time via the Roblox Analytics Query API.
  • Alerts: automatic warnings when health drops, such as servers going offline or player counts crashing.

Setup

  1. Upgrade to a plan that includes the Community Health Dashboard.
  2. Link your Discord server in the Discord tab and enable logging.
  3. Connect your Roblox group in the Background Checks tab for group rank data.
  4. Make sure your in-game setup script is sending telemetry to /api/telemetry/health.
  5. Open the Community Health tab in the dashboard to view live data.

Telemetry Endpoints

The dashboard consumes health snapshots from:

  • POST /api/telemetry/health — in-game server snapshots.
  • GET /api/games/[gameId]/analytics — aggregated health and community analytics.

Health Severity Levels

  • Green: All systems normal. Servers online, player counts stable, no blockers.
  • Yellow: Warning. Elevated latency, low player count, or non-critical errors detected.
  • Red: Critical. Servers offline, telemetry missing, or severe player-impacting issues.

Troubleshooting

  • If the tab shows no data, confirm the game has an active Open Cloud API key and the setup script is running on the server.
  • If Discord metrics are missing, make sure the bot has access to the server and guild insights are not disabled.
  • If Roblox group data is empty, verify the group ID and rank sync are configured in Background Checks.
  • If revenue and paying users are not showing, your Open Cloud API key must have the universe.analytics:read permission enabled in the Creator Dashboard credentials page.
  • Performance metrics (FPS, CPU, memory, crashes) only retain 28 days of history. If no data appears, try selecting a time range within the last month.