spark - 性能分析器

spark 是一款适用于 Minecraft 客户端、服务器和代理的性能分析工具。

💡简介

spark 由多个组件构成，能帮助您诊断性能问题、检查内存状况并监控服务器整体健康度。

🎮核心功能

CPU 性能分析器

用于诊断“卡顿”、低 tick 率、高 CPU 使用率等性能问题。

• 轻量级：可在生产环境中运行，影响极小。
• 易于使用：无需配置或设置，安装插件/模组即可。
• 快速出结果：仅需运行约 30 秒即可获得对性能问题区域的有效洞察。
• 高度可定制：可针对特定线程、设置特定采样间隔、仅记录“卡顿”时段等。
• 高度可读：简单的树状结构便于分析和解读。查看器还可应用反混淆映射。

其工作原理是采样系统活动的统计数据，并基于此构建调用图。调用图随后会在在线查看器中显示，供用户进一步分析。

提供两种不同的分析器引擎

• Native AsyncGetCallTrace + perf_events：使用 async-profiler（仅适用于 Linux x86_64 系统）。
• 内置 Java ThreadMXBean：sk89q 开发的流行 WarmRoast 分析器的改进版本。

内存检查

包含多种工具，用于诊断服务器的内存问题。

• 堆内存摘要：获取并分析服务器内存的基本快照。
• 查看 JVM 堆的简单视图，了解每个类的内存使用情况和实例计数。
• 并非旨在完全替代专业的内存分析工具。
• 堆内存转储：获取服务器内存的完整 (HPROF) 快照。
• 转储（并可选择压缩）JVM 堆的完整快照。
• 随后可使用常规分析工具检查此快照。
• GC 监控：监控服务器上的垃圾回收活动。
• 允许用户将 GC 活动与游戏服务器卡顿关联起来，轻松查看其耗时和释放的内存量。
• 观察新生代/老年代垃圾回收的频率/时长，为调整 GC 标志提供依据。

服务器健康报告

spark 可以报告一系列概括服务器整体健康状况的指标。

这些指标包括

• TPS：每秒刻数，比 /tps 命令显示的精度更高。
• Tick 时长：每个游戏刻的耗时（最小值、最大值和平均值）。
• CPU 使用率：服务器进程以及整个系统的 CPU 使用情况。
• 内存使用率：进程使用的内存量。
• 磁盘使用率：系统可用/已用的磁盘空间。

除了提供平均 tick 率，spark 还能监控单个游戏刻——当单个游戏刻的时长超过特定阈值时发送报告。这有助于识别趋势以及性能问题相对于其他系统或游戏事件的性质。

🔧使用与安装

安装

只需将 spark.jar 文件放入服务器的 plugins 目录即可。

命令使用

有关如何使用命令的信息，请查阅文档。

获取帮助

如果您需要帮助分析性能分析报告，或者只是想聊聊天，欢迎加入我们的 Discord。

✨指南

文档中提供了一些简短的“指南”，涵盖以下主题

• 游戏刻循环
• 查找卡顿峰值的原因