# Prometheus Exporter<\/p>\n
A PaperMC plugin that exposes server metrics to Prometheus via an HTTP endpoint.<\/p>\n
The metrics endpoint starts automatically on port `9940`.<\/p>\n
## Configuration<\/p>\n
`plugins\/PrometheusExporter\/config.yml`:<\/p>\n
“`yaml
\nmetrics-port: 9940
\ncollection-interval-ticks: 20 # 20 ticks = 1 second
\n“`<\/p>\n
## Scraping<\/p>\n
Point Prometheus at:<\/p>\n
“` Example `prometheus.yml`:<\/p>\n “`yaml ## Metrics<\/p>\n ### Server<\/p>\n | Metric | Labels | Description | ### Per-world<\/p>\n | Metric | Labels | Description | ### Per-player<\/p>\n | Metric | Labels | Description | ### JVM<\/p>\n | Metric | Labels | Description | A PaperMC plugin that exposes server metrics to Prometheus via an HTTP endpoint.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"prometheus-exporter","_minecraft_project_id":"jeG4qkik","_minecraft_author":"hank880907","_minecraft_license":"MIT","_minecraft_downloads":10,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"prometheus-exporter.zip","_minecraft_size_bytes":4608769,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T23:07:24.682418Z","_minecraft_date_created":"2026-05-10T00:58:09.004903Z","_minecraft_date_modified":"2026-05-07T04:56:03.125019Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/prometheus-exporter","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T09:12:53+00:00","_minecraft_import_hash":"40d44ce974b9dc6c2adfd7605f6ca87d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127],"mod_loader":[132],"minecraft_version":[83,167,163],"class_list":["post-125687","mod","type-mod","status-publish","hentry","mod_category-paper","mod_loader-paper","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\nhttp:\/\/
\n“`<\/p>\n
\nscrape_configs:
\n – job_name: minecraft
\n static_configs:
\n – targets: [“
\n“`<\/p>\n
\n| ————————— | —————————— | ————————————————— |
\n| `mc_tps` | `window` (`1m`, `5m`, `15m`) | Server ticks per second |
\n| `mc_mspt_milliseconds` | \u2014 | Average milliseconds per tick (last 100 ticks) |
\n| `mc_tick_time_milliseconds` | `quantile` (`max`, `p95`) | Tick duration quantiles over the last 100 ticks |
\n| `mc_players_online` | \u2014 | Current online player count |
\n| `mc_players_max` | \u2014 | Maximum player slots |
\n| `mc_current_tick` | \u2014 | Monotonically increasing tick counter |
\n| `mc_worlds` | \u2014 | Number of currently loaded worlds |<\/p>\n
\n| ——————————– | ————— | ——————————————————– |
\n| `mc_world_players` | `world` | Players per world |
\n| `mc_world_loaded_chunks` | `world` | Loaded chunks per world |
\n| `mc_world_entities` | `world` | Total entity count per world |
\n| `mc_world_entities_by_type` | `world`, `type` | Entity count broken down by type (e.g. `zombie`, `cow`) per world |
\n| `mc_world_tile_entities` | `world` | Tile entity count per world |
\n| `mc_world_ticking_tile_entities` | `world` | Ticking tile entity count per world |
\n| `mc_world_time` | `world` | In-game clock (0\u201324000); tracks day\/night cycle |
\n| `mc_world_storm` | `world` | 1 if a storm is active, 0 otherwise |
\n| `mc_world_thundering` | `world` | 1 if a thunderstorm is active, 0 otherwise |<\/p>\n
\n| —————————– | —————- | ———————————————- |
\n| `mc_player_ping_milliseconds` | `player` | Latency per player |
\n| `mc_player_health` | `player` | Current health per player |
\n| `mc_player_max_health` | `player` | Max health per player (useful when custom attributes are applied) |
\n| `mc_player_food_level` | `player` | Hunger level per player (0\u201320) |
\n| `mc_player_saturation` | `player` | Saturation per player (0.0\u201320.0+) |
\n| `mc_player_xp_level` | `player` | XP level per player |
\n| `mc_player_xp_progress` | `player` | Fractional XP progress within current level (0.0\u20131.0) |
\n| `mc_player_total_experience` | `player` | Total accumulated XP per player |
\n| `mc_player_flying` | `player` | 1 if the player is flying, 0 otherwise |
\n| `mc_player_gamemode` | `player` | Numeric active gamemode (0 = survival, 1 = creative, 2 = adventure, 3 = spectator) |<\/p>\n
\n| ——- | ——- | ————————————- |
\n| `jvm_*` | various | JVM heap, GC, threads, classloaders |<\/p>\n","protected":false},"excerpt":{"rendered":"