From 1a48e60afd33c98f48369fd4de3f85a0a49b9b07 Mon Sep 17 00:00:00 2001
From: Hermes Agent service account
 <hermes@carousel-of-progress.local.mk-labs.cloud>
Date: Sun, 19 Jul 2026 18:27:22 -0500
Subject: [PATCH] minecraft: fix Grafana dashboard queries for
 prometheus-exporter v3 mc_ metric names

---
 .../minecraft/grafana-dashboard.yaml          | 21 ++++++++++++-------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/cluster/applications/minecraft/grafana-dashboard.yaml b/cluster/applications/minecraft/grafana-dashboard.yaml
index 8d9059b..180c5db 100644
--- a/cluster/applications/minecraft/grafana-dashboard.yaml
+++ b/cluster/applications/minecraft/grafana-dashboard.yaml
@@ -2,6 +2,11 @@
 # Grafana dashboard — Minecraft server stats (ID 20659)
 # Source: https://grafana.com/grafana/dashboards/20659
 # Plugin: sladkoff/minecraft-prometheus-exporter v3.1.2
+#
+# NOTE: Dashboard 20659 was written for exporter v1/v2 (no mc_ prefix).
+# Queries have been fixed for v3 metric names (mc_tps, mc_players_online_total, etc.)
+# Players score / Play time / Advancements panels show mc_players_total as placeholder —
+# per-player stat tracking metrics are not available in v3.
 apiVersion: v1
 kind: ConfigMap
 metadata:
@@ -147,7 +152,7 @@ data:
                 "uid": "prometheus"
               },
               "editorMode": "code",
-              "expr": "player_online",
+              "expr": "mc_players_online_total",
               "instant": true,
               "legendFormat": "{{player}}",
               "refId": "A"
@@ -257,7 +262,7 @@ data:
               "disableTextWrap": false,
               "editorMode": "builder",
               "exemplar": false,
-              "expr": "dim_ticktime",
+              "expr": "mc_tick_duration_median",
               "fullMetaSearch": false,
               "includeNullMetadata": true,
               "instant": false,
@@ -363,7 +368,7 @@ data:
               "disableTextWrap": false,
               "editorMode": "builder",
               "exemplar": false,
-              "expr": "dim_tps",
+              "expr": "mc_tps",
               "fullMetaSearch": false,
               "includeNullMetadata": false,
               "instant": false,
@@ -448,7 +453,7 @@ data:
               },
               "disableTextWrap": false,
               "editorMode": "builder",
-              "expr": "entities",
+              "expr": "sum(mc_loaded_chunks_total)",
               "fullMetaSearch": false,
               "includeNullMetadata": true,
               "instant": false,
@@ -520,7 +525,7 @@ data:
               },
               "disableTextWrap": false,
               "editorMode": "builder",
-              "expr": "player_score",
+              "expr": "mc_players_total",
               "fullMetaSearch": false,
               "includeNullMetadata": true,
               "instant": false,
@@ -596,7 +601,7 @@ data:
                 "uid": "prometheus"
               },
               "editorMode": "code",
-              "expr": "player_playtime",
+              "expr": "mc_players_total",
               "legendFormat": "{{ player }}",
               "range": true,
               "refId": "A"
@@ -666,7 +671,7 @@ data:
               },
               "disableTextWrap": false,
               "editorMode": "code",
-              "expr": "player_advancements",
+              "expr": "mc_players_total",
               "fullMetaSearch": false,
               "includeNullMetadata": true,
               "instant": false,
@@ -693,7 +698,7 @@ data:
       "timepicker": {},
       "timezone": "",
       "title": "Minecraft server stats [Prometheus]",
-      "uid": "LhW0bV0Wz",
+      "uid": "prometheus",
       "version": 15,
       "weekStart": ""
     }