ServerPulse is an open-source, real-time performance monitoring tool for Minecraft servers. It collects key server metrics (TPS, disk usage, memory, player count, entities, chunks, ping) and visualizes them through an integrated Grafana dashboard.
📊 View Dashboard Examples
Example dashboard view 1: General Server Overview
Example dashboard view 2: Per-World Details
Example dashboard view 3: Players Ping Overview
- Goal: Provide an extensible, lightweight plugin to gather server metrics and store them in InfluxDB for visualization with Grafana.
- Tech stack:
- Java (plugin) → InfluxDB
- Grafana dashboard (preconfigured via provisioning)
- Discord alerts for key server metrics
- Docker Compose (for InfluxDB & Grafana setup)
ServerPulse now supports all Minecraft server platforms in the Bukkit/Paper ecosystem:
- Bukkit/Spigot: Full support with custom TPS monitoring implementation
- Paper and its forks (Purpur, Pufferfish, etc.): Enhanced support with native TPS monitoring
- Velocity: Support for Velocity proxy servers (ofc TPS and world metrics are not available)
The plugin automatically detects your server platform and uses the most efficient implementation available for that environment.
ServerPulse isn't just another metrics exporter - it offers several unique advantages:
- Complete Monitoring Stack - Fully integrated solution with InfluxDB (optimized for time-series data) and pre-configured Grafana dashboards
- Universal Platform Support - Works with any Bukkit-based and Velocity server while taking advantage of Paper-specific optimizations when available
- Per-World Analytics - Track entity counts, chunk loading, and performance metrics separately for each world
- Flexible Tagging System - Group and filter metrics by server, network, region, or any custom dimension through simple configuration
- Zero-Configuration Dashboards - Auto-provisioned Grafana dashboards - no manual setup required
- Alert Notifications - Integrated Discord and Telegram alerts for critical server metrics (TPS drops, memory issues, etc.)
- Production-Ready Infrastructure - Built-in health checks, connection retry mechanisms, and proper error handling
- Docker-First Deployment - Single command deployment with Docker Compose for the entire monitoring stack
For setup guides, configuration instructions, API examples, and developer information, please visit our Wiki.
The wiki contains comprehensive documentation on:
- Installation and setup instructions
- Configuration options and customization
- Discord and Telegram alerts configuration
- Custom dashboard creation
- Developer API examples
- Contributing guidelines
| Feature | ServerPulse | Generic Prometheus Exporters |
|---|---|---|
| Setup Time | ~5 minutes with Docker Compose | Manual metrics + Prometheus + Grafana setup |
| Dashboard Configuration | Pre-configured, auto-provisioned | Manual dashboard creation |
| Data Storage | InfluxDB (optimized for time-series) | Prometheus (general-purpose) |
| Platform Support | All Bukkit-based servers | Varies by implementation |
| Per-World Metrics | Built-in | Usually not available |
| Custom Tagging | Flexible tag system | Limited labeling |
| Alert System | Discord and Telegram integration | Requires manual setup |
| Infrastructure | Complete stack included | Manual integration required |
| Health Monitoring | Automated health checks | Varies by implementation |
We welcome all contributions — bug reports, feature proposals, pull requests, or simply feedback. Read Contributing
ServerPulse is licensed under the GNU General Public License v3.0.