Author SHA1 Message Date
Renovate Bot 7b78de2ea1 chore(deps): update gradle docker tag to v9.4 2026-03-04 20:05:53 +00:00
dmg 56549fe10a feat: add per-player placement and crafting metrics
Build / build (push) Successful in 2m0s
2026-01-28 00:05:29 -05:00
dmg 0e0a435767 feat: add per-player movement and block metrics
Build / build (push) Successful in 2m21s
2026-01-28 00:01:59 -05:00
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
8 changed files with 1136 additions and 1 deletions
+1 -1
View File
@@ -1,4 +1,4 @@
FROM gradle:9.3-jdk21 FROM gradle:9.4-jdk21
WORKDIR /workspace WORKDIR /workspace
+7
View File
@@ -84,6 +84,7 @@ Some metrics depend on server implementations (TPS/MSPT, player ping, tile entit
| --- | --- | --- | --- | | --- | --- | --- | --- |
| spigot_chat_messages_total | counter | none | Total chat messages sent | | spigot_chat_messages_total | counter | none | Total chat messages sent |
| spigot_player_movements_total | counter | none | Total player movement events | | spigot_player_movements_total | counter | none | Total player movement events |
| spigot_player_movements_by_player_total | counter | player | Player movements by player |
| spigot_players_joined_total | counter | none | Total player joins | | spigot_players_joined_total | counter | none | Total player joins |
| spigot_players_quit_total | counter | none | Total player quits | | spigot_players_quit_total | counter | none | Total player quits |
| spigot_chunk_loads_total | counter | none | Total chunk load events | | spigot_chunk_loads_total | counter | none | Total chunk load events |
@@ -92,6 +93,12 @@ 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_broken_by_player_total | counter | player,material | Blocks broken by player and material |
| spigot_blocks_placed_total | counter | material | Blocks placed by material |
| spigot_blocks_placed_by_player_total | counter | player,material | Blocks placed by player and material |
| spigot_items_crafted_total | counter | material | Items crafted by material |
| spigot_items_crafted_by_player_total | counter | player,material | Items crafted by player and 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 |
File diff suppressed because it is too large Load Diff
@@ -15,5 +15,6 @@ public final class BlockBreakListener implements Listener {
@EventHandler @EventHandler
public void onBlockBreak(BlockBreakEvent event) { public void onBlockBreak(BlockBreakEvent event) {
registry.incrementBlocksBroken(event.getBlock().getType()); registry.incrementBlocksBroken(event.getBlock().getType());
registry.incrementBlocksBroken(event.getBlock().getType(), event.getPlayer().getName());
} }
} }
@@ -15,5 +15,6 @@ public final class BlockPlaceListener implements Listener {
@EventHandler @EventHandler
public void onBlockPlace(BlockPlaceEvent event) { public void onBlockPlace(BlockPlaceEvent event) {
registry.incrementBlocksPlaced(event.getBlockPlaced().getType()); registry.incrementBlocksPlaced(event.getBlockPlaced().getType());
registry.incrementBlocksPlaced(event.getBlockPlaced().getType(), event.getPlayer().getName());
} }
} }
@@ -2,6 +2,7 @@ package com.prometheus.spigot.listeners;
import com.prometheus.spigot.metrics.MetricsRegistry; import com.prometheus.spigot.metrics.MetricsRegistry;
import org.bukkit.Material; import org.bukkit.Material;
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler; import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener; import org.bukkit.event.Listener;
import org.bukkit.event.inventory.CraftItemEvent; import org.bukkit.event.inventory.CraftItemEvent;
@@ -21,5 +22,8 @@ public final class CraftListener implements Listener {
return; return;
} }
registry.incrementItemsCrafted(result.getType()); registry.incrementItemsCrafted(result.getType());
if (event.getWhoClicked() instanceof Player player) {
registry.incrementItemsCrafted(result.getType(), player.getName());
}
} }
} }
@@ -20,6 +20,7 @@ public final class MoveListener implements Listener {
return; return;
} }
registry.incrementPlayerMovements(); registry.incrementPlayerMovements();
registry.incrementPlayerMovements(event.getPlayer().getName());
} }
private boolean hasChangedBlock(PlayerMoveEvent event) { private boolean hasChangedBlock(PlayerMoveEvent event) {
@@ -46,12 +46,16 @@ public final class MetricsRegistry {
private final LongAdder pluginDisables = new LongAdder(); private final LongAdder pluginDisables = new LongAdder();
private final ConcurrentHashMap<String, LongAdder> blocksPlacedByMaterial = new ConcurrentHashMap<>(); private final ConcurrentHashMap<String, LongAdder> blocksPlacedByMaterial = new ConcurrentHashMap<>();
private final ConcurrentHashMap<String, LongAdder> blocksBrokenByMaterial = new ConcurrentHashMap<>(); private final ConcurrentHashMap<String, LongAdder> blocksBrokenByMaterial = new ConcurrentHashMap<>();
private final ConcurrentHashMap<LabelPair, LongAdder> blocksBrokenByPlayerMaterial = new ConcurrentHashMap<>();
private final ConcurrentHashMap<LabelPair, LongAdder> blocksPlacedByPlayerMaterial = new ConcurrentHashMap<>();
private final ConcurrentHashMap<String, LongAdder> deathsByCause = new ConcurrentHashMap<>(); private final ConcurrentHashMap<String, LongAdder> deathsByCause = new ConcurrentHashMap<>();
private final ConcurrentHashMap<String, LongAdder> loginFailuresByReason = new ConcurrentHashMap<>(); private final ConcurrentHashMap<String, LongAdder> loginFailuresByReason = new ConcurrentHashMap<>();
private final ConcurrentHashMap<String, LongAdder> commandsBlocked = new ConcurrentHashMap<>(); private final ConcurrentHashMap<String, LongAdder> commandsBlocked = new ConcurrentHashMap<>();
private final ConcurrentHashMap<LabelPair, LongAdder> commandsExecuted = new ConcurrentHashMap<>(); private final ConcurrentHashMap<LabelPair, LongAdder> commandsExecuted = new ConcurrentHashMap<>();
private final ConcurrentHashMap<String, LongAdder> itemsCraftedByMaterial = new ConcurrentHashMap<>(); private final ConcurrentHashMap<String, LongAdder> itemsCraftedByMaterial = new ConcurrentHashMap<>();
private final ConcurrentHashMap<LabelPair, LongAdder> itemsCraftedByPlayerMaterial = new ConcurrentHashMap<>();
private final ConcurrentHashMap<LabelPair, LongAdder> entityKills = new ConcurrentHashMap<>(); private final ConcurrentHashMap<LabelPair, LongAdder> entityKills = new ConcurrentHashMap<>();
private final ConcurrentHashMap<String, LongAdder> playerMovementsByPlayer = new ConcurrentHashMap<>();
public MetricsRegistry(Server server, boolean enableJvm, boolean enableProcess) { public MetricsRegistry(Server server, boolean enableJvm, boolean enableProcess) {
this.server = server; this.server = server;
@@ -72,6 +76,10 @@ public final class MetricsRegistry {
playerMovements.increment(); playerMovements.increment();
} }
public void incrementPlayerMovements(String player) {
incrementLabeledCounter(playerMovementsByPlayer, player);
}
public void incrementPlayerJoins() { public void incrementPlayerJoins() {
playerJoins.increment(); playerJoins.increment();
} }
@@ -88,10 +96,26 @@ public final class MetricsRegistry {
incrementLabeledCounter(blocksBrokenByMaterial, material.name()); incrementLabeledCounter(blocksBrokenByMaterial, material.name());
} }
public void incrementBlocksBroken(Material material, String player) {
String normalizedMaterial = normalizeLabel(material.name());
String normalizedPlayer = normalizeLabel(player);
blocksBrokenByPlayerMaterial
.computeIfAbsent(new LabelPair(normalizedPlayer, normalizedMaterial), key -> new LongAdder())
.increment();
}
public void incrementBlocksPlaced(Material material) { public void incrementBlocksPlaced(Material material) {
incrementLabeledCounter(blocksPlacedByMaterial, material.name()); incrementLabeledCounter(blocksPlacedByMaterial, material.name());
} }
public void incrementBlocksPlaced(Material material, String player) {
String normalizedMaterial = normalizeLabel(material.name());
String normalizedPlayer = normalizeLabel(player);
blocksPlacedByPlayerMaterial
.computeIfAbsent(new LabelPair(normalizedPlayer, normalizedMaterial), key -> new LongAdder())
.increment();
}
public void incrementPlayerDeath(EntityDamageEvent.DamageCause cause) { public void incrementPlayerDeath(EntityDamageEvent.DamageCause cause) {
incrementLabeledCounter(deathsByCause, cause.name()); incrementLabeledCounter(deathsByCause, cause.name());
} }
@@ -134,6 +158,14 @@ public final class MetricsRegistry {
incrementLabeledCounter(itemsCraftedByMaterial, material.name()); incrementLabeledCounter(itemsCraftedByMaterial, material.name());
} }
public void incrementItemsCrafted(Material material, String player) {
String normalizedMaterial = normalizeLabel(material.name());
String normalizedPlayer = normalizeLabel(player);
itemsCraftedByPlayerMaterial
.computeIfAbsent(new LabelPair(normalizedPlayer, normalizedMaterial), key -> new LongAdder())
.increment();
}
public void incrementEntityKill(EntityType entityType, String killer) { public void incrementEntityKill(EntityType entityType, String killer) {
String normalizedEntity = normalizeLabel(entityType.name()); String normalizedEntity = normalizeLabel(entityType.name());
String normalizedKiller = normalizeLabel(killer); String normalizedKiller = normalizeLabel(killer);
@@ -185,13 +217,21 @@ public final class MetricsRegistry {
appendCounter(builder, "spigot_plugin_disable_total", "Total plugin disable events", pluginDisables.sum()); appendCounter(builder, "spigot_plugin_disable_total", "Total plugin disable events", pluginDisables.sum());
appendLabeledCounterAdder(builder, "spigot_blocks_broken_total", "Blocks broken by material", "material", blocksBrokenByMaterial); appendLabeledCounterAdder(builder, "spigot_blocks_broken_total", "Blocks broken by material", "material", blocksBrokenByMaterial);
appendLabeledCounterAdder(builder, "spigot_blocks_broken_by_player_total", "Blocks broken by player and material", "player",
"material", blocksBrokenByPlayerMaterial);
appendLabeledCounterAdder(builder, "spigot_blocks_placed_total", "Blocks placed by material", "material", blocksPlacedByMaterial); appendLabeledCounterAdder(builder, "spigot_blocks_placed_total", "Blocks placed by material", "material", blocksPlacedByMaterial);
appendLabeledCounterAdder(builder, "spigot_blocks_placed_by_player_total", "Blocks placed by player and material", "player",
"material", blocksPlacedByPlayerMaterial);
appendLabeledCounterAdder(builder, "spigot_player_deaths_total", "Player deaths by cause", "cause", deathsByCause); appendLabeledCounterAdder(builder, "spigot_player_deaths_total", "Player deaths by cause", "cause", deathsByCause);
appendLabeledCounterAdder(builder, "spigot_player_logins_failed_total", "Failed player logins by reason", "reason", loginFailuresByReason); appendLabeledCounterAdder(builder, "spigot_player_logins_failed_total", "Failed player logins by reason", "reason", loginFailuresByReason);
appendLabeledCounterAdder(builder, "spigot_commands_blocked_total", "Blocked commands by name", "command", commandsBlocked); appendLabeledCounterAdder(builder, "spigot_commands_blocked_total", "Blocked commands by name", "command", commandsBlocked);
appendLabeledCounterAdder(builder, "spigot_commands_executed_total", "Commands executed by source", "command", "source", commandsExecuted); appendLabeledCounterAdder(builder, "spigot_commands_executed_total", "Commands executed by source", "command", "source", commandsExecuted);
appendLabeledCounterAdder(builder, "spigot_items_crafted_total", "Items crafted by material", "material", itemsCraftedByMaterial); appendLabeledCounterAdder(builder, "spigot_items_crafted_total", "Items crafted by material", "material", itemsCraftedByMaterial);
appendLabeledCounterAdder(builder, "spigot_items_crafted_by_player_total", "Items crafted by player and material", "player",
"material", itemsCraftedByPlayerMaterial);
appendLabeledCounterAdder(builder, "spigot_entities_killed_total", "Entities killed by player", "entity", "killer", entityKills); appendLabeledCounterAdder(builder, "spigot_entities_killed_total", "Entities killed by player", "entity", "killer", entityKills);
appendLabeledCounterAdder(builder, "spigot_player_movements_by_player_total", "Player movements by player", "player",
playerMovementsByPlayer);
appendGauge(builder, "spigot_players_online", "Online player count", server.getOnlinePlayers().size()); appendGauge(builder, "spigot_players_online", "Online player count", server.getOnlinePlayers().size());
appendGauge(builder, "spigot_players_max", "Max player slots", server.getMaxPlayers()); appendGauge(builder, "spigot_players_max", "Max player slots", server.getMaxPlayers());