PerfTriage

PerfTriage

自动捕获Fabric服务器上的卡顿事件,并指向可疑的热点区块。

管理

⚡ PerfTriage – 面向 Fabric 服务端的自动卡顿取证工具

Fabric MC 1.21.4 Server Side Client Side Production Safe


在卡顿发生时自动捕获

PerfTriage 是一个轻量级的 服务端卡顿分诊模组,适用于 Fabric。

它在正常游戏过程中保持静默。 当你的服务器出现持续的 MSPT 飙升时,它会自动捕获一份结构化的诊断快照,记录 加载了什么、集中在何处,以及哪些区块最可疑。

它只为一个实际问题而生:

当卡顿发生时,到底发生了什么?


为什么要安装 PerfTriage?

大多数服务端卡顿 并非 发生在你正在主动进行性能分析的时候。

等到玩家反馈:

  • “服务器卡死了”
  • “某个区域出问题了”
  • “TPS 又掉了”

……那一刻往往已经过去了。

PerfTriage 正是为此问题而设计。

它不作为重型常驻分析器运行,而是等待有意义的卡顿峰值出现,然后记录一份聚焦的报告,让你在 事件发生之后 仍有证据可查。

文本报告显示 MSPT 平均值 / p95 / 最大值,以及顶级实体类型


PerfTriage 检测的内容

PerfTriage 监控:

  • 持续的 MSPT 飙升
  • 卡顿后的自动恢复
  • 基于冷却的转储节流
  • 硬性扫描预算保护

触发时,它会生成结构化报告,包含:

Tick 分析

  • 窗口化 MSPT 统计(avg / p95 / max)
  • 采样时长
  • 预算使用情况
  • 扫描截断状态

世界快照

  • 每个维度的已加载区块数
  • 实体 / 方块实体总数
  • 顶级实体类型
  • 顶级方块实体类型

热点分析

  • 主导实体类型
  • 主导方块实体类型
  • 区块级集中度
  • 每 tick 平均数量
  • 预算信息
  • 区块扫描能力标记

报告异步写入:

config/perftriage/reports/

两种格式:

  • .txt 供人阅读
  • .json 供工具处理

为什么热点区块很重要

卡顿通常由局部集中引起,而不仅仅是全局负载。

典型例子包括:

  • 物品 / 生物 / 船泛滥
  • 红石机器
  • 刷怪场
  • 幽匿农场
  • 区块加载器
  • 集中分布在少数区块中的异常装置

PerfTriage 不仅告诉你 加载了什么, 它还告诉你 集中在哪里。

这意味着你可以:

  • 直接传送到问题区域
  • 检查受影响的区块
  • 移除来源
  • 立即验证改善效果

文本报告显示 entity_hot_type、entity_hot_chunks_topN


PerfTriage 与 spark 对比

PerfTriage 不是 spark 等完整分析器的替代品。

它们解决不同的问题。

工具 最适合 典型工作流
PerfTriage 自动捕获卡顿事件 安装后等待峰值出现
spark 深度分析与根因调查 需要时手动运行
两者结合 先捕获,后调查 最佳整体工作流

PerfTriage 用于 自动事件捕获。 spark 用于 在你知道该看哪里之后进行更深入的分析。

这就是它们配合良好的原因。


谁应该安装?

PerfTriage 尤其适用于:

  • 只在玩家抱怨后才注意到卡顿的服主
  • 需要区块坐标而非仅仅“服务器很慢”的管理员
  • 不希望常驻性能分析的生产服务器
  • 存在难以手动复现的间歇性卡顿的服务器

对比 PerfTriage 与 Spark


它的不同之处?

PerfTriage 不会 持续对 tick 函数进行插桩。

相反,它专注于:

  • 仅在 meaningful 卡顿时激活
  • 使用严格的扫描与采样预算
  • 避免繁重的后台开销
  • 生成确定性的快照
  • 提供区块级定位

这使得它适用于稳定性至关重要的真实服务器。


命令

手动转储

/perftriage dump now

状态

/perftriage status

显示:

  • 当前 MSPT 窗口统计
  • 剩余冷却时间
  • 上次报告路径
  • 恢复状态

热点输出示例

entity_hot_type: minecraft:acacia_boat
entity_hot_chunks_topN:
  - -4,-4: 35320
  - -4,-3: 35280
  - -5,-3: 31600

这意味着检测到的大部分热点数量集中在这些区块中。


兼容性

  • Fabric Loader 0.18+
  • Minecraft 1.21.4
  • 服务端

设计理念

PerfTriage 专注于:

  • 低开销
  • 确定性的诊断
  • 自动运行
  • 生产安全

它旨在帮助你在卡顿发生时保留证据,而不是迫使你在事后猜测。


路线图

  • 多版本支持(1.20.x / 1.21.x)
  • 可选的 Top-K 类型区块细分
  • 可配置阈值
  • 报告索引聚合
  • 可选的分析器集成模式

许可证

MIT


为真实服务器而构建。 为真实卡顿而设计。


本模组每周更新,可能一周一到两次。