Prometheus Exporter
A PaperMC plugin that exposes server metrics to Prometheus via an HTTP endpoint.
The metrics endpoint starts automatically on port 9940.
Configuration
plugins/PrometheusExporter/config.yml:
metrics-port: 9940
collection-interval-ticks: 20 # 20 ticks = 1 second
Scraping
Point Prometheus at:
http://<server-ip>:9940/metrics
Example prometheus.yml:
scrape_configs:
- job_name: minecraft
static_configs:
- targets: ["<server-ip>:9940"]
Metrics
Server
| Metric | Labels | Description |
|---|---|---|
mc_tps |
window (1m, 5m, 15m) |
Server ticks per second |
mc_mspt_milliseconds |
— | Average milliseconds per tick (last 100 ticks) |
mc_tick_time_milliseconds |
quantile (max, p95) |
Tick duration quantiles over the last 100 ticks |
mc_players_online |
— | Current online player count |
mc_players_max |
— | Maximum player slots |
mc_current_tick |
— | Monotonically increasing tick counter |
mc_worlds |
— | Number of currently loaded worlds |
Per-world
| Metric | Labels | Description |
|---|---|---|
mc_world_players |
world |
Players per world |
mc_world_loaded_chunks |
world |
Loaded chunks per world |
mc_world_entities |
world |
Total entity count per world |
mc_world_entities_by_type |
world, type |
Entity count broken down by type (e.g. zombie, cow) per world |
mc_world_tile_entities |
world |
Tile entity count per world |
mc_world_ticking_tile_entities |
world |
Ticking tile entity count per world |
mc_world_time |
world |
In-game clock (0–24000); tracks day/night cycle |
mc_world_storm |
world |
1 if a storm is active, 0 otherwise |
mc_world_thundering |
world |
1 if a thunderstorm is active, 0 otherwise |
Per-player
| Metric | Labels | Description |
|---|---|---|
mc_player_ping_milliseconds |
player |
Latency per player |
mc_player_health |
player |
Current health per player |
mc_player_max_health |
player |
Max health per player (useful when custom attributes are applied) |
mc_player_food_level |
player |
Hunger level per player (0–20) |
mc_player_saturation |
player |
Saturation per player (0.0–20.0+) |
mc_player_xp_level |
player |
XP level per player |
mc_player_xp_progress |
player |
Fractional XP progress within current level (0.0–1.0) |
mc_player_total_experience |
player |
Total accumulated XP per player |
mc_player_flying |
player |
1 if the player is flying, 0 otherwise |
mc_player_gamemode |
player |
Numeric active gamemode (0 = survival, 1 = creative, 2 = adventure, 3 = spectator) |
JVM
| Metric | Labels | Description |
|---|---|---|
jvm_* |
various | JVM heap, GC, threads, classloaders |
