MineMetrics

MineMetrics

一个为 Minecraft 1.21.1 打造的轻量级服务端 NeoForge 模组，可将你的服务器转变为实时的 Prometheus 指标源。将其放入 mods/ 文件夹后，它便会提供一个 /metrics 端点（默认 0.0.0.0:19565），任何 Prometheus 实例均可抓取——无需捆绑第三方库，无需客户端安装，且对服务器刻速率的影响微乎其微。

它公开了真正解释服务器性能的关键数据：

• 刻： TPS、平均/最大 MSPT 以及累计刻计数器
• 世界： 每个维度的已加载区块、实体（可选按类型细分）以及玩家数量
• JVM： 堆内/堆外及各内存池使用情况、堆外缓冲区、垃圾回收、线程、类加载以及 JIT 编译
• 主机： 进程与系统 CPU 使用率、系统内存总量/已用容量以及服务器磁盘的可用空间

其突出特性在于按模组划分的 CPU 归因。内置的采样分析器会持续监控服务器线程，并报告每个已安装模组消耗的 CPU 量（minecraft_mod_cpu_seconds_total{mod="..."}）——涵盖了事件处理器、方块实体刻以及 Mixin。当服务器开始卡顿时，你可以直接从仪表盘中看到哪个模组是罪魁祸首，无需手动运行分析器。

配置

附带的 Docker Compose 技术栈（含预构建、易读仪表盘的 Prometheus + Grafana）可让你在数分钟内完成从安装到生成图表的过程——详见监控技术栈仓库（ https://github.com/hxxp-rhys/MineMetrics ）。所有内容均可配置：绑定地址、端口、采样率以及可选指标，而玩家身份默认选择公开，以保护隐私。

许可证

采用 MIT 许可证，且 100% 无依赖。