2 Commits
Author SHA1 Message Date
dmg 6ee2bbf7e8 feat: add grafana dashboard
Build / build (push) Successful in 1m58s
2026-01-27 23:55:49 -05:00
dmg 02b5639666 docs: update metrics list
Build / build (push) Successful in 1m55s
2026-01-27 23:23:41 -05:00
2 changed files with 933 additions and 0 deletions
+3
View File
@@ -92,6 +92,9 @@ Some metrics depend on server implementations (TPS/MSPT, player ping, tile entit
| spigot_plugin_enable_total | counter | none | Total plugin enable events | | spigot_plugin_enable_total | counter | none | Total plugin enable events |
| spigot_plugin_disable_total | counter | none | Total plugin disable events | | spigot_plugin_disable_total | counter | none | Total plugin disable events |
| spigot_blocks_broken_total | counter | material | Blocks broken by material | | spigot_blocks_broken_total | counter | material | Blocks broken by material |
| spigot_blocks_placed_total | counter | material | Blocks placed by material |
| spigot_items_crafted_total | counter | material | Items crafted by material |
| spigot_entities_killed_total | counter | entity,killer | Entities killed by player |
| spigot_player_deaths_total | counter | cause | Player deaths by cause | | spigot_player_deaths_total | counter | cause | Player deaths by cause |
| spigot_player_logins_failed_total | counter | reason | Failed player logins by reason | | spigot_player_logins_failed_total | counter | reason | Failed player logins by reason |
| spigot_commands_blocked_total | counter | command | Blocked commands by name | | spigot_commands_blocked_total | counter | command | Blocked commands by name |
+930
View File
@@ -0,0 +1,930 @@
{
"__inputs": [
{
"name": "DS_PROMETHEUS",
"label": "Prometheus",
"description": "",
"type": "datasource",
"pluginId": "prometheus",
"pluginName": "Prometheus"
}
],
"__requires": [
{
"type": "grafana",
"id": "grafana",
"name": "Grafana",
"version": "10.4.0"
},
{
"type": "datasource",
"id": "prometheus",
"name": "Prometheus",
"version": "1.0.0"
}
],
"annotations": {
"list": [
{
"builtIn": 1,
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"enable": true,
"hide": true,
"iconColor": "rgba(0, 211, 255, 1)",
"name": "Annotations & Alerts",
"type": "dashboard"
}
]
},
"editable": true,
"fiscalYearStartMonth": 0,
"graphTooltip": 0,
"id": null,
"links": [],
"panels": [
{
"collapsed": false,
"gridPos": {
"h": 1,
"w": 24,
"x": 0,
"y": 0
},
"id": 1,
"panels": [],
"title": "Overview",
"type": "row"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"decimals": 0,
"unit": "short"
},
"overrides": []
},
"gridPos": {
"h": 6,
"w": 8,
"x": 0,
"y": 1
},
"id": 2,
"options": {
"colorMode": "value",
"graphMode": "area",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"textMode": "auto"
},
"targets": [
{
"expr": "spigot_players_online{instance=~\"$server\"}",
"legendFormat": "online",
"refId": "A"
}
],
"title": "Players Online",
"type": "stat"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"decimals": 2,
"unit": "short"
},
"overrides": []
},
"gridPos": {
"h": 6,
"w": 8,
"x": 8,
"y": 1
},
"id": 3,
"options": {
"colorMode": "value",
"graphMode": "area",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"textMode": "auto"
},
"targets": [
{
"expr": "spigot_tps{instance=~\"$server\",interval=\"1m\"}",
"legendFormat": "tps",
"refId": "A"
}
],
"title": "TPS (1m)",
"type": "stat"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"decimals": 2,
"unit": "ms"
},
"overrides": []
},
"gridPos": {
"h": 6,
"w": 8,
"x": 16,
"y": 1
},
"id": 4,
"options": {
"colorMode": "value",
"graphMode": "area",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"textMode": "auto"
},
"targets": [
{
"expr": "spigot_mspt{instance=~\"$server\"}",
"legendFormat": "mspt",
"refId": "A"
}
],
"title": "MSPT",
"type": "stat"
},
{
"collapsed": false,
"gridPos": {
"h": 1,
"w": 24,
"x": 0,
"y": 7
},
"id": 5,
"panels": [],
"title": "Activity",
"type": "row"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"unit": "ops"
},
"overrides": []
},
"gridPos": {
"h": 8,
"w": 12,
"x": 0,
"y": 8
},
"id": 6,
"options": {
"legend": {
"displayMode": "list",
"placement": "bottom"
}
},
"targets": [
{
"expr": "rate(spigot_chat_messages_total{instance=~\"$server\"}[5m])",
"legendFormat": "chat/s",
"refId": "A"
},
{
"expr": "rate(spigot_players_joined_total{instance=~\"$server\"}[5m])",
"legendFormat": "joins/s",
"refId": "B"
},
{
"expr": "rate(spigot_players_quit_total{instance=~\"$server\"}[5m])",
"legendFormat": "quits/s",
"refId": "C"
}
],
"title": "Chat + Joins/Quits",
"type": "timeseries"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"decimals": 2,
"unit": "ops"
},
"overrides": []
},
"gridPos": {
"h": 8,
"w": 6,
"x": 12,
"y": 8
},
"id": 7,
"options": {
"colorMode": "value",
"graphMode": "area",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"textMode": "auto"
},
"targets": [
{
"expr": "rate(spigot_player_movements_total{instance=~\"$server\"}[5m])",
"legendFormat": "moves/s",
"refId": "A"
}
],
"title": "Movement Rate",
"type": "stat"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"decimals": 2,
"unit": "ops"
},
"overrides": []
},
"gridPos": {
"h": 8,
"w": 6,
"x": 18,
"y": 8
},
"id": 8,
"options": {
"colorMode": "value",
"graphMode": "area",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"textMode": "auto"
},
"targets": [
{
"expr": "sum(rate(spigot_commands_executed_total{instance=~\"$server\"}[5m]))",
"legendFormat": "commands/s",
"refId": "A"
}
],
"title": "Command Rate",
"type": "stat"
},
{
"collapsed": false,
"gridPos": {
"h": 1,
"w": 24,
"x": 0,
"y": 16
},
"id": 9,
"panels": [],
"title": "Blocks & Crafting",
"type": "row"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"unit": "ops"
},
"overrides": []
},
"gridPos": {
"h": 9,
"w": 12,
"x": 0,
"y": 17
},
"id": 10,
"options": {
"displayMode": "gradient",
"minVizWidth": 0,
"minVizHeight": 10,
"orientation": "horizontal",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"showUnfilled": true
},
"targets": [
{
"expr": "topk(10, sum by (material) (rate(spigot_blocks_broken_total{instance=~\"$server\"}[5m])))",
"legendFormat": "{{material}}",
"refId": "A"
}
],
"title": "Blocks Broken (Top 10)",
"type": "bargauge"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"unit": "ops"
},
"overrides": []
},
"gridPos": {
"h": 9,
"w": 12,
"x": 12,
"y": 17
},
"id": 11,
"options": {
"displayMode": "gradient",
"minVizWidth": 0,
"minVizHeight": 10,
"orientation": "horizontal",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"showUnfilled": true
},
"targets": [
{
"expr": "topk(10, sum by (material) (rate(spigot_blocks_placed_total{instance=~\"$server\"}[5m])))",
"legendFormat": "{{material}}",
"refId": "A"
}
],
"title": "Blocks Placed (Top 10)",
"type": "bargauge"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"unit": "ops"
},
"overrides": []
},
"gridPos": {
"h": 9,
"w": 12,
"x": 0,
"y": 26
},
"id": 12,
"options": {
"displayMode": "gradient",
"minVizWidth": 0,
"minVizHeight": 10,
"orientation": "horizontal",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"showUnfilled": true
},
"targets": [
{
"expr": "topk(10, sum by (material) (rate(spigot_items_crafted_total{instance=~\"$server\"}[5m])))",
"legendFormat": "{{material}}",
"refId": "A"
}
],
"title": "Items Crafted (Top 10)",
"type": "bargauge"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"unit": "ops"
},
"overrides": []
},
"gridPos": {
"h": 9,
"w": 12,
"x": 12,
"y": 26
},
"id": 13,
"options": {
"legend": {
"displayMode": "list",
"placement": "bottom"
}
},
"targets": [
{
"expr": "sum by (cause) (rate(spigot_player_deaths_total{instance=~\"$server\"}[5m]))",
"legendFormat": "{{cause}}",
"refId": "A"
}
],
"title": "Player Deaths by Cause",
"type": "timeseries"
},
{
"collapsed": false,
"gridPos": {
"h": 1,
"w": 24,
"x": 0,
"y": 35
},
"id": 14,
"panels": [],
"title": "World & Tasks",
"type": "row"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"decimals": 0,
"unit": "short"
},
"overrides": []
},
"gridPos": {
"h": 6,
"w": 6,
"x": 0,
"y": 36
},
"id": 15,
"options": {
"colorMode": "value",
"graphMode": "area",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"textMode": "auto"
},
"targets": [
{
"expr": "spigot_chunks_loaded{instance=~\"$server\"}",
"legendFormat": "chunks",
"refId": "A"
}
],
"title": "Chunks Loaded",
"type": "stat"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"decimals": 0,
"unit": "short"
},
"overrides": []
},
"gridPos": {
"h": 6,
"w": 6,
"x": 6,
"y": 36
},
"id": 16,
"options": {
"colorMode": "value",
"graphMode": "area",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"textMode": "auto"
},
"targets": [
{
"expr": "spigot_worlds_loaded{instance=~\"$server\"}",
"legendFormat": "worlds",
"refId": "A"
}
],
"title": "Worlds Loaded",
"type": "stat"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"decimals": 0,
"unit": "short"
},
"overrides": []
},
"gridPos": {
"h": 6,
"w": 6,
"x": 12,
"y": 36
},
"id": 17,
"options": {
"colorMode": "value",
"graphMode": "area",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"textMode": "auto"
},
"targets": [
{
"expr": "spigot_tasks_running{instance=~\"$server\"}",
"legendFormat": "running",
"refId": "A"
}
],
"title": "Tasks Running",
"type": "stat"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"decimals": 0,
"unit": "short"
},
"overrides": []
},
"gridPos": {
"h": 6,
"w": 6,
"x": 18,
"y": 36
},
"id": 18,
"options": {
"colorMode": "value",
"graphMode": "area",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"textMode": "auto"
},
"targets": [
{
"expr": "spigot_tasks_pending{instance=~\"$server\"}",
"legendFormat": "pending",
"refId": "A"
}
],
"title": "Tasks Pending",
"type": "stat"
},
{
"collapsed": false,
"gridPos": {
"h": 1,
"w": 24,
"x": 0,
"y": 42
},
"id": 19,
"panels": [],
"title": "Entities",
"type": "row"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"unit": "short"
},
"overrides": []
},
"gridPos": {
"h": 9,
"w": 12,
"x": 0,
"y": 43
},
"id": 20,
"options": {
"displayMode": "gradient",
"minVizWidth": 0,
"minVizHeight": 10,
"orientation": "horizontal",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"showUnfilled": true
},
"targets": [
{
"expr": "topk(10, spigot_entities_total{instance=~\"$server\"})",
"legendFormat": "{{type}}",
"refId": "A"
}
],
"title": "Entities by Type (Top 10)",
"type": "bargauge"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"unit": "ops"
},
"overrides": []
},
"gridPos": {
"h": 9,
"w": 12,
"x": 12,
"y": 43
},
"id": 21,
"options": {
"showHeader": true
},
"targets": [
{
"expr": "topk(10, sum by (entity, killer) (rate(spigot_entities_killed_total{instance=~\"$server\"}[5m])))",
"format": "table",
"legendFormat": "{{entity}} by {{killer}}",
"refId": "A"
}
],
"title": "Entity Kills (Top 10)",
"type": "table"
},
{
"collapsed": false,
"gridPos": {
"h": 1,
"w": 24,
"x": 0,
"y": 52
},
"id": 22,
"panels": [],
"title": "Performance",
"type": "row"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"unit": "bytes"
},
"overrides": []
},
"gridPos": {
"h": 8,
"w": 12,
"x": 0,
"y": 53
},
"id": 23,
"options": {
"legend": {
"displayMode": "list",
"placement": "bottom"
}
},
"targets": [
{
"expr": "jvm_memory_used_bytes{instance=~\"$server\"}",
"legendFormat": "used {{area}}",
"refId": "A"
},
{
"expr": "jvm_memory_max_bytes{instance=~\"$server\"}",
"legendFormat": "max {{area}}",
"refId": "B"
}
],
"title": "JVM Memory",
"type": "timeseries"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"decimals": 0,
"unit": "short"
},
"overrides": []
},
"gridPos": {
"h": 8,
"w": 6,
"x": 12,
"y": 53
},
"id": 24,
"options": {
"colorMode": "value",
"graphMode": "none",
"reduceOptions": {
"calcs": [
"lastNotNull"
],
"fields": "",
"values": false
},
"textMode": "auto"
},
"targets": [
{
"expr": "jvm_threads{instance=~\"$server\"}",
"legendFormat": "threads",
"refId": "A"
}
],
"title": "JVM Threads",
"type": "stat"
},
{
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"fieldConfig": {
"defaults": {
"unit": "ops"
},
"overrides": []
},
"gridPos": {
"h": 8,
"w": 6,
"x": 18,
"y": 53
},
"id": 25,
"options": {
"legend": {
"displayMode": "list",
"placement": "bottom"
}
},
"targets": [
{
"expr": "sum by (gc) (rate(jvm_gc_pause_seconds_count{instance=~\"$server\"}[5m]))",
"legendFormat": "{{gc}}",
"refId": "A"
}
],
"title": "GC Pause Rate",
"type": "timeseries"
}
],
"refresh": "30s",
"schemaVersion": 38,
"style": "dark",
"tags": [
"minecraft",
"spigot",
"prometheus"
],
"templating": {
"list": [
{
"current": {},
"datasource": {
"type": "prometheus",
"uid": "${DS_PROMETHEUS}"
},
"definition": "label_values(jvm_gc_pause_seconds_count, instance)",
"hide": 0,
"includeAll": false,
"label": "Server",
"multi": false,
"name": "server",
"query": {
"query": "label_values(jvm_gc_pause_seconds_count, instance)",
"refId": "StandardVariableQuery"
},
"refresh": 1,
"sort": 1,
"type": "query"
}
]
},
"time": {
"from": "now-6h",
"to": "now"
},
"timepicker": {},
"timezone": "browser",
"title": "Prometheus Spigot",
"uid": "prometheus-spigot",
"version": 3,
"weekStart": ""
}