Reports & exports
ServersPulse generates automated performance reports and lets you export raw metric data for external analysis.
Weekly reports
Weekly reports are auto-generated every Monday at 08:00 UTC for each server. They summarize the previous week's performance in a single report.
Weekly reports are available on Pro and Multi plans.
Report contents
Each weekly report includes:
TPS summary
- Average TPS -- Mean TPS over the week
- Minimum TPS -- Lowest recorded TPS value
- Max MSPT -- Highest recorded milliseconds-per-tick
- Time below threshold -- Total seconds where TPS was below 18.0
Memory summary
- Average used -- Mean memory usage in MB
- Peak used -- Highest recorded memory usage in MB
- Average max -- Mean allocated heap size in MB
- Average utilization -- Mean memory usage as a percentage of allocated
Player summary
- Peak concurrent -- Highest number of simultaneous players
- Average online -- Mean player count during the week
Incident summary
- Total incidents -- Count of all incidents during the week
- By type -- Breakdown of incidents by type (TPS drop, crash, offline, etc.)
- By severity -- Count of warning vs. critical incidents
Top lag periods
The report highlights the worst performance moments of the week, showing the timestamp, TPS, and MSPT for each lag spike.
Top worlds
The busiest worlds ranked by average entity and chunk counts, helping identify which worlds contribute most to load.
Week-over-week comparison
Each report includes a comparison with the previous week:
- TPS change -- Percentage change in average TPS
- Memory change -- Percentage change in average memory usage
- Incident change -- Absolute change in incident count
This helps you quickly see whether server health is improving or degrading.
Viewing reports
Reports are accessible from the Reports section in the dashboard sidebar. Each report shows the week range (start to end date) and the full data breakdown described above.
Data exports
You can export raw metric data for external analysis, custom dashboards, or record-keeping.
Data exports are available on Pro and Multi plans.
CSV export
Export server metrics as a CSV file. The export includes timestamped rows of TPS, MSPT, memory, and player count values for the selected time range.
JSON export
Export server metrics as JSON. This format is suitable for programmatic consumption, custom visualizations, or feeding into other monitoring tools.
How to export
- Navigate to the export option in the dashboard
- Select the server and time range
- Choose the format (CSV or JSON)
- Download the file
Export data respects your plan's data retention limits -- you can only export data within your retention window.
Data retention by plan
| Plan | Data retention |
|---|---|
| Free | 14 days |
| Starter | 30 days |
| Pro | 90 days |
| Multi | 90 days |
Data older than your retention window is automatically cleaned up and cannot be exported.
Contributors
Thanks to everyone who keeps this docs area accurate.
