spark

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

实用链接

• Website - 浏览项目主页
• Documentation - 阅读文档和使用指南
• Downloads - 最新的插件/模组下载

spark 由 BisectHosting 提供赞助。​

BisectHosting 是 Minecraft 服务器托管专家，随时准备帮助你创建并托管属于你自己的服务器！他们是在社区中备受信赖、根基深厚的托管服务商，并提供出色的服务水平，我们也很乐意推荐。spark 用户还可享受专属 25% 折扣——点击上方链接，立即创建你的服务器。

spark 能做什么？

spark 由三个独立组件构成：

• CPU Profiler：诊断性能问题。
• Memory Inspection：诊断内存问题。
• Server Health Reporting：跟踪服务器整体健康状况。

⚡ CPU Profiler

spark 的分析器可用于诊断性能问题：“卡顿”、低 tick 速率、高 CPU 占用等。

它具有以下特点：

• 轻量 - 可在生产环境中运行，影响极小。
• 易于使用 - 无需任何配置或设置，只需安装插件。
• 快速产出结果 - 只需运行约 30 秒，就足以对性能问题区域产生有价值的洞察。
• 可自定义 - 可调整为针对特定线程、按特定间隔采样、仅记录“卡顿”时段等
• 高度可读 - 简单的树状结构便于分析和解读。查看器还可以应用反混淆映射。

它通过对系统活动的统计数据进行采样，并基于这些数据构建调用图来工作。随后，调用图会显示在一个在线查看器中，供用户进一步分析。

有两种不同的分析器引擎：

• 原生 AsyncGetCallTrace + perfevents - 使用 async-profiler（仅在 Linux x8664 系统上可用）
• 内置 Java ThreadMXBean - 由 sk89q 开发的热门 WarmRoast profiler 的改进版本。

⚡ Memory Inspection

spark 包含许多可用于诊断服务器内存问题的工具。

• Heap Summary - 获取并分析服务器内存的基础快照
• 以简单视图展示 JVM 堆，可查看每个类的内存使用量和实例数量
• 不打算完全替代专业的内存分析工具。（见下文）
• Heap Dump - 获取服务器内存的完整（HPROF）快照
• 导出（并可选择压缩）JVM 堆的完整快照。
• 随后可使用常规分析工具检查该快照。
• GC Monitoring - 监控服务器上的垃圾回收活动
• 允许用户将 GC 活动与游戏服务器卡死关联起来，并轻松查看其耗时以及释放了多少内存。
• 观察新生代/老年代垃圾回收的频率与持续时间，以帮助判断应使用哪些 GC 调优参数

⚡ Server Health Reporting

spark 可以报告多项用于总结服务器整体健康状况的指标。

这些指标包括：

• TPS - 每秒 tick 数，比 /tps 命令显示得更精确
• Tick Durations - 每个 tick 的耗时（最小、最大和平均）
• CPU Usage - 服务器进程以及整个系统的 CPU 使用情况
• Memory Usage - 进程使用了多少内存
• Disk Usage - 系统剩余/已使用的磁盘空间

除了提供 tick 速率平均值外，spark 还可以监控单个 tick——当单个 tick 的持续时间超过某个阈值时发送报告。这可用于识别性能问题的趋势和性质，并将其与其他系统或游戏事件联系起来分析。

用法

安装时，只需将 .jar 文件放入你的 mods 目录中。

关于如何使用命令的信息可在文档中找到。

如果你希望获得有关分析性能报告的帮助，或者只是想聊天，欢迎加入我们的 Discord。

指南

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

• The tick loop
• Finding the cause of lag spikes