This mod provides a Prometheus exporter for Minecraft. It exports metrics related to the Minecraft server and the JVM for consumption by the open-source systems monitoring toolkit, Prometheus. The mod is intended for server-side use, and does not need to be installed client-side. This currently has builds for the following versions:
- Minecraft 1.21.1 with Fabric 0.103.0.
- Minecraft 1.21.1 with Forge 52.0.0.
- Minecraft 1.21.1 with NeoForge 21.1.0.
- Minecraft 1.20.6 with Fabric 0.100.0.
- Minecraft 1.20.6 with Forge 50.1.0.
- Minecraft 1.20.6 with NeoForge 20.6.0.
- Minecraft 1.20.4 with Fabric 0.97.0.
- Minecraft 1.20.4 with Forge 49.1.0.
- Minecraft 1.20.4 with NeoForge 20.4.0.
- Minecraft 1.20.2 with Forge 48.1.0.
- Minecraft 1.20.1 with Fabric 0.92.0.
- Minecraft 1.20.1 with Forge 47.1.0.
- Minecraft 1.19.3 with Forge 44.1.0.
- Minecraft 1.19.2 with Forge 43.0.0.
- Minecraft 1.18.2 with Forge 40.2.0.
- Minecraft 1.18.1 with Forge 39.0.0.
- Minecraft 1.16.5 with Forge 36.2.0.
- Minecraft 1.15.2 with Forge 21.2.0.
- Minecraft 1.14.4 with Forge 28.1.0.
- Minecraft 1.12.2 with Forge 14.23.0.
- Minecraft 1.7.10 with Forge 10.13.4.
Is there a newer version of Minecraft not listed? Is the mod outdated for one of the listed Minecraft versions? Let me know by opening an issue on GitHub.
The Prometheus Exporter mod only needs to be installed on the server. It can be downloaded from GitHub and Curse Forge. To install it, copy the JAR (Prometheus-Exporter-{MC Version}-{Mod Loader}-{Mod Version}.jar) to the server mods/ directory. Since this mod does not add anything to the Minecraft world, it can be safely upgraded by simply replacing an older version with a newer version.
The mod configuration is located at world/serverconfig/prometheus_exporter-server.toml with Forge and Fabric, and config/prometheus_exporter-server.toml with NeoForge. It will be automatically generated upon server start if it does not already exist. The default configuration can be seen in the example prometheus_exporter-server.toml.
The metrics are documented in metrics.md.
A sample output from the exporter can be seen in the example output.txt.
Known compatible Grafana dashboards are listed in dashboards.md.