Skip to content
This repository has been archived by the owner on Sep 10, 2021. It is now read-only.

Stonebound/PrometheusExporter

 
 

Repository files navigation

Minecraft Prometheus Exporter

A Sponge plugin which exports Minecraft server stats for Prometheus.

Quick Start

Drop the the plugin jar into your servers mods directory and start your server.

After startup, the Prometheus metrics endpoint should be available at localhost:9225/metrics (assuming localhost is the server hostname).

The metrics port can be customized in the plugin's config file (a default config will be created after the first use).

Prometheus config

Add the following job to the scrape_configs section of your Prometheus configuration:

Single Server

- job_name: 'minecraft'
  static_configs:
    - targets: ['localhost:9225']

Multiple Server

  - job_name: 'minecraft'
    static_configs:
      - targets: ['localhost:9225']
        labels:
          group: 'server1'
      - targets: ['localhost:9226']
        labels:
          group: 'server2'
      - targets: ['localhost:9226']
        labels:
          group: 'server3'

In the grafana json add {group="serverX"} to each search query.

Import Grafana Dashboard

  1. Navigate to Grafana -> Dashboards -> Import
  2. Paste in or upload minecraft-grafana.json
  3. Update "JVM Memory Used" to reflect your server max memory (Default 8G)
  4. Edit (bottom right widget) -> Options -> Gauage -> Max

Available metrics

These are the stats that are currently exported by the plugin.

Label Description
mc_players_total Online and Max Online players
mc_tps Overall tps
mc_loaded_chunks_total Chunks loaded per world
mc_players_online_total Online players per world
mc_entities_total Entities loaded per world
mc_tile_entities_total Tile Entities loaded per world
mc_jvm_memory JVM memory usage