Monitoring Overview
The VoxelBench monitoring system collects real-time performance metrics from your Minecraft server and displays them on an interactive dashboard.
Collected Metrics
| Metric | Description | Update Frequency |
|---|---|---|
| TPS | Ticks per second (target: 20) | Every snapshot (~60s) |
| MSPT | Milliseconds per tick | Every snapshot |
| Player Count | Online players | Every snapshot |
| Entity Count | Loaded entities | Every snapshot |
| Loaded Chunks | Number of loaded chunks | Every snapshot |
| RAM Usage | JVM heap memory used (MB) | Every snapshot |
| RAM Max | JVM max heap allocation (MB) | Every snapshot |
| CPU Usage | JVM process CPU (% of total machine) | Every snapshot |
| CPU System | Whole machine CPU (% all processes) | Every snapshot |
| CPU Cores | Available CPU cores | Every snapshot |
| GC Pause | Garbage collection pause time (ms, delta) | Every snapshot |
| GC Count | Number of GC collections (delta) | Every snapshot |
Data Retention
Data is automatically aggregated and cleaned up to keep storage efficient:
| Granularity | Resolution | Retention |
|---|---|---|
| Raw | ~1 point/minute | 48 hours |
| 5-minute | 1 point/5min | 7 days |
| 1-hour | 1 point/hour | 30 days |
| 1-day | 1 point/day | 1 year |
This means you get second-level precision for the last 2 days, minute-level for the last week, and hour-level for the last month.
Online/Offline Detection
The plugin sends a lightweight heartbeat every 30 seconds. If 3 consecutive heartbeats are missed (90 seconds), the server is marked as offline. This detection is fast enough to catch crashes while tolerating brief network hiccups.
Enabling Monitoring
- Link your server to your account
- Go to Dashboard > My Servers > select your server
- Click Enable Monitoring
- The plugin will start sending metrics automatically