BlackBox - 服务器诊断

插件

原名 BlackBox - Server Diagnostics · 作者 MrDino

一个用于你的 Paper 服务器的黑匣子——记录性能、调查卡顿、定位热点、分析崩溃,并找出问题所在。

0 本站下载 0 关注 更新于 1 个月前

最新 0.6.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

⬛ BlackBox

BlackBox Main Banner

BlackBox 是一款面向 Paper 服务器的高级可观测性与诊断插件。

它持续记录服务器性能和活动,以便在发生卡顿、TPS 下降、崩溃或异常行为时,提供调查所需的信息,帮助你了解发生了什么、何时发生、何地发生以及当时正在运行什么。

BlackBox 不依赖单一的 TPS 数值,而是将性能指标、JVM 资源、区块、实体、服务器事件、插件、日志和实时 Java 分析数据整合到一个诊断系统中。

? 监控你的服务器

遥测数据会持续收集并异步写入,以最小化对主服务器线程的工作负担。

BlackBox Features Banner

? 调查性能问题

当配置的 TPS 或刻时间阈值超出时,BlackBox 会自动检测性能事件。

对于每次事故,它可以分析:

  • 问题开始和恢复的时间
  • 最低 TPS 和最大刻时间
  • 事故前、中、后的性能表现
  • CPU、内存和 GC(垃圾回收)的变化
  • 实体和区块的活动
  • 服务器事件和热点
  • 警告和异常
  • JFR 分析证据
  • 可能的原因及相关证据

BlackBox 区分直接证据和相关性,而不是自动归咎于某个插件、实体或区块。

? 查找热点

BlackBox 可以按世界和区块追踪活动,帮助你定位值得深入调查的区域。

它监控的事件包括:

  • 实体的生成与移除
  • 区块的加载与卸载
  • 红石活动
  • 漏斗和物品栏传输
  • 活塞和爆炸
  • 方块变化
  • 刷怪笼和命令方块
  • 强制加载区块和插件票证

可疑热点可以与高 MSPT 或低 TPS 时段相关联,并提供坐标以便在游戏中轻松检查。

? Java Flight Recorder

BlackBox 集成了 Java Flight Recorder (JFR) 以实现更深入的分析。

分析可以手动启动:

/blackbox profile 60

或者在 BlackBox 检测到重复的性能问题时自动启动。

JFR 分析可以提供关于以下内容的信息:

  • CPU 采样和耗时方法
  • 插件调用栈帧
  • 垃圾回收
  • 文件 I/O
  • Socket I/O
  • I/O 延迟

生成的 .jfr 文件也可以使用 IntelliJ Profiler 或 JDK Mission Control 打开以进行进一步调查。

? 插件、日志与崩溃诊断

BlackBox Diagnostic Banner

BlackBox 会清点已安装的插件及其依赖项、命令、权限、监听器和计划任务。

它还监控服务器日志,并能识别与以下常见问题相关的内容:

  • ⚙️ 配置
  • ? 插件代码
  • ? 依赖项和不兼容的版本
  • ? 文件和权限
  • ?️ 数据库
  • ? 网络
  • ☕ JVM 资源
  • ⏱️ Can't keep up / 刻落后
  • ? Watchdog 事件

还可以分析最近的崩溃报告,以识别根本异常、相关调用栈帧和常见的故障模式。

?️ 世界诊断

BlackBox 不仅能调查当前加载的区块。

其离线区域普查功能可以在不将区块加载到 Paper 中的情况下检查 Minecraft .mca 文件,检测有关存储区块、实体、方块实体、NBT 问题和区域结构的信息。

BlackBox 还可以分析命令方块和数据包函数,查找可能耗时的模式,如宽泛的选择器、重复召唤、大量粒子使用、forceload、大型 fill/clone 操作以及复杂的命令链。

? 详细报告

BlackBox Reports Banner

为任何可用的时间段生成诊断报告:

/blackbox report 30m

/blackbox report 6h

/blackbox report 2d

BlackBox 可以生成:

  • ? 专业 PDF 报告
  • ? 可搜索的 Markdown 报告
  • ? 详细的 CSV 遥测数据

报告将性能、事件、CPU、内存、JVM 资源、热点、实体、插件、错误、JFR 分析、世界信息和其他证据整合到一份调查中。

BlackBox 还可以在服务器正常关闭时自动生成报告。

⌨️ 命令

BlackBox Commands Banner

命令 描述
/blackbox status 显示最新的服务器健康信息
/blackbox scan 排队执行完整的已加载区块扫描
/blackbox report <time> 生成诊断报告
/blackbox profile <seconds> 启动 Java Flight Recorder 分析
/bb /blackbox 的别名

权限: blackbox.admin
默认: OP

? 隐私

BlackBox 将诊断信息存储在本地服务器上。

根据你的配置,遥测数据可能包含玩家名称、UUID、位置、命令和错误信息。

隐私控制允许限制与玩家相关的信息,而网络地址可以哈希处理、明文存储或完全禁用。

BlackBox 的报告、分析和遥测数据应被视为私有的服务器运营数据。

⚙️ 兼容性

BlackBox Compatibility Banner

平台 Paper
Minecraft 1.21.4 – 26.3
需要客户端模组 ❌ 否
依赖项 ❌ 无
仅服务端 ✅ 是

? 安装

  1. 下载 BlackBox。
  2. 将 .jar 文件放入服务器的 plugins 文件夹中。
  3. 启动或重启服务器。
  4. 运行 /blackbox status。
  5. 完成!

BlackBox 旨在在整个服务器的生命周期内保持活跃,以便在出现问题时诊断证据已经存在。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源