spark

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

(CurseForge上的版本仅适用于Forge/Fabric！)

有用的链接

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

Spark由BisectHosting自豪地赞助。​

BisectHosting是Minecraft服务器托管专家，随时准备帮助您创建并托管自己的服务器！他们是社区中值得信赖且成熟的托管服务提供商，提供卓越的服务水平，我们很乐意推荐。Spark用户可享受 七五折 的特别折扣 - 点击上方链接，即刻创建您的服务器。

它有什么作用？

Spark由多个组件组成，下面将分别详细介绍。

⚡ CPU分析器

Spark的分析器可用于诊断性能问题：“延迟”、低刻速率、高CPU使用率等。

它具有以下特点：

• 轻量级 - 可在生产环境中运行，对系统影响极小。
• 易于使用 - 无需配置或设置，只需安装插件/模组。
• 快速生成结果 - 仅运行约30秒，即可对性能问题区域生成有用的见解。
• 可定制 - 可调整以针对特定线程，按特定间隔采样，仅记录“延迟”时段等。
• 可读性强 - 简单的树形结构便于分析和解读。查看器还可应用反混淆映射。

它通过采样服务器活动的统计数据，并基于此数据构建调用图来工作。然后，调用图会在在线查看器中显示，供用户进一步分析。

⚡ 内存检查

Spark包含一些有助于诊断服务器内存问题的工具。

堆摘要 - 对服务器内存进行基本快照并分析

• 对JVM堆的简单视图，可查看每个类的内存使用情况和实例计数。
• 并非旨在完全替代专业的内存分析工具。（见下文）

堆转储 - 对服务器内存进行完整（HPROF）快照

• 转储（并可选择压缩）JVM堆的完整快照。
• 然后可使用常规分析工具检查此快照。

GC监控 - 监控服务器上的垃圾回收活动

• 允许用户将GC活动与游戏服务器卡顿相关联，并轻松查看它们持续的时间以及释放了多少内存。
• 观察新生代/老年代垃圾回收的频率/持续时间，以确定使用哪些GC调优标志。

⚡ 服务器健康报告

Spark可以报告一些总结服务器整体健康状况的指标。

这些指标包括：

• TPS - 每秒刻数，比 /tps 命令显示的精度更高。
• 刻持续时间 - 每个刻的耗时（最小值、最大值和平均值）。
• CPU使用率 - 服务器进程以及整个系统使用了多少CPU资源。
• 内存使用率 - 进程使用了多少内存。
• 磁盘使用率 - 系统有多少磁盘空间可用/已使用。

除了提供刻速率平均值外，Spark还可以 监控单个刻 - 当单个刻的持续时间超过特定阈值时发送报告。这可用于识别性能问题的趋势和性质，以及与其他系统或游戏事件的关系。

使用方法

安装时，只需将 .jar 文件添加到您的模组目录中。

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

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

指南

文档中有一些小型“指南”，涵盖以下主题。

• 刻循环
• 查找延迟峰值的原因

spark is a performance profiler for Minecraft clients, servers and proxies. 

(The version here on CurseForge is for Forge/Fabric only!)

Useful Links

• Website - browse the project homepage
  
• Documentation - read documentation and usage guides
• Downloads - latest plugin/mod downloads

spark is proudly sponsored by BisectHosting.​

BisectHosting are Minecraft server hosting experts, ready to help you create and host your very own server! They are a trusted and well-established hosting provider in the community, and provide an outstanding level of service that we are happy to recommend. There is a special 25% off discount available for spark users - click the link above to create your server today.

What does it do?

spark is made up of a number of components, each detailed separately below.

⚡ CPU Profiler

spark's profiler can be used to diagnose performance issues: "lag", low tick rate, high CPU usage, etc.

It is:

• Lightweight - can be ran in production with minimal impact.
• Easy to use - no configuration or setup necessary, just install the plugin/mod.
• Quick to produce results - running for just ~30 seconds is enough to produce useful insights into problematic areas for performance.
• Customisable - can be tuned to target specific threads, sample at a specific interval, record only "laggy" periods, etc
• Highly readable - simple tree structure lends itself to easy analysis and interpretation. The viewer can also apply deobfuscation mappings.

It works by sampling statistical data about the servers activity, and constructing a call graph based on this data. The call graph is then displayed in an online viewer for further analysis by the user.

⚡ Memory Inspection

spark includes a number of tools which are useful for diagnosing memory issues with a server.

Heap Summary - take & analyse a basic snapshot of the servers memory

• A simple view of the JVM's heap, see memory usage and instance counts for each class
• Not intended to be a full replacement of proper memory analysis tools. (see below)

Heap Dump - take a full (HPROF) snapshot of the servers memory

• Dumps (& optionally compresses) a full snapshot of JVM's heap.
• This snapshot can then be inspected using conventional analysis tools.

GC Monitoring - monitor garbage collection activity on the server

• Allows the user to relate GC activity to game server hangs, and easily see how long they are taking & how much memory is being free'd.
• Observe frequency/duration of young/old generation garbage collections to inform which GC tuning flags to use

⚡ Server Health Reporting

spark can report a number of metrics summarising the servers overall health.

These metrics include:

• TPS - ticks per second, to a more accurate degree indicated by the /tps command
• Tick Durations - how long each tick is taking (min, max and average)
• CPU Usage - how much of the CPU is being used by the server process, and by the overall system
• Memory Usage - how much memory is being used by the process
• Disk Usage - how much disk space is free/being used by the system

As well as providing tick rate averages, spark can also monitor individual ticks - sending a report whenever a single tick's duration exceeds a certain threshold. This can be used to identify trends and the nature of performance issues, relative to other system or game events.

Usage

To install, just add the .jar file to your mods directory.

Information about how to use commands can be found in the docs.

If you’d like help analysing a profiling report, or just want to chat, feel free to join us on Discord.

Guides

There are a few small "guides" available in the docs, covering the following topics.

• The tick loop
• Finding the cause of lag spikes