Reports & exports
ServersPulse generates automated performance reports and lets you export player, retention, and incident 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 when the server owner's plan is Pro or Multi. Collaborators see reports only for servers whose owner enables the feature and that remain within the owner's server limit.
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 player summaries, player sessions, retention rows, and incident timelines for external analysis or record-keeping.
Data exports are available when the server owner's plan is Pro or Multi. A fleet export applies only to accessible servers whose owners enable exports and whose servers remain within their plan limit; the export metadata lists the applied and omitted server scope.
CSV export
Export any supported dataset as a CSV file with stable columns and export metadata.
JSON export
Export any supported dataset as JSON. This format is suitable for programmatic consumption or custom analysis.
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 each server owner's retention limit -- you can only export data within the applicable server's retention window.
Data retention by plan
| Plan | Data retention |
|---|---|
| Free | 30 days |
| Starter | 30 days |
| Pro | 90 days |
| Multi | 90 days |
Exports are limited to the server owner's retention window. Metric and world-metric history is cleaned up on that schedule; other datasets may have different storage schedules but cannot be queried beyond the enforced window.
Contributors
Thanks to everyone who keeps this docs area accurate.
