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

Point Prometheus at:

http://<server-ip>:9940/metrics

Example prometheus.yml:

scrape_configs:
  - job_name: minecraft
    static_configs:
      - targets: ["<server-ip>:9940"]

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

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

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)

Metric	Labels	Description
`jvm_*`	various	JVM heap, GC, threads, classloaders