/spark tps

基本信息

属性 值
命令名 tps
别名 cpu
来源 HealthModule.tps（HealthModule.java:72）
参数 无
Tab 补全 Command.TabCompleter.empty() —— 不补全

一次性打印 TPS、tick 时长与 CPU 占用。不接受任何参数，传入的 flag 会被忽略。

功能

输出分三段（HealthModule.tps）：

1. TPS（仅当平台提供 tick 统计时）

标题固定为「TPS from last 5s, 10s, 1m, 5m, 15m:」，后接五个窗口的数值，逗号分隔。统计源为 SparkTickStatistics，由 tick hook / tick reporter 驱动（SparkPlatform.enable 中把 tickStatistics 注册为二者的 callback）。

2. tick 时长（仅当 tickStatistics.isDurationSupported() 为真）

标题为「Tick durations (min/med/95%ile/max ms) from last 10s, 1m:」，两个窗口用 ; 分隔。

3. CPU 占用（无条件输出）

标题「CPU usage from last 10s, 1m, 15m:」，分两行：

  • 第一行三值为系统负载，末尾标注 (system)
  • 第二行三值为进程负载，末尾标注 (process)

数据源为 CpuMonitor 的滚动平均（CpuMonitor.systemLoad*Avg / CpuMonitor.processLoad*Avg）。CpuMonitor 是全局单例，在 SparkPlatform.enable 中通过 CpuMonitor.ensureMonitoring() 启动（依赖 OSHI 读取系统指标）。

数值

数值名 值 来源
TPS 统计窗口 5s / 10s / 1m / 5m / 15m HealthModule.tps
tick 时长统计窗口 10s / 1m HealthModule.tps
tick 时长分位数 min / median / 95th percentile / max StatisticFormatter.formatTickDurations
CPU 统计窗口 10s / 1m / 15m HealthModule.tps

交互

触发 行为
服务端执行 统计服务端 tick；tick 统计由 Forge1710TickHook（TickEvent.Type.SERVER）与 Forge1710TickReporter 提供
客户端执行 统计客户端 tick；由 Forge1710TickHook（TickEvent.Type.CLIENT）与 Forge1710TickReporter 提供
平台不支持 tick 统计 跳过第 1、2 段，仅输出 CPU 占用

相关条目