VCAnalyser

插件

· 作者 likhoded

一个智能系统,用于分析 MSPT 和 TPS 下降的原因,以及 RAM 和 CPU 的消耗情况。

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

最新 1.0.0 · 26.1.2 · Bukkit / Paper

一键开服(送7天)
En
问题 VCAnalyser 的作用
"服务器卡顿,原因不明" 汇总报告:TPS/MSPT、内存、CPU、实体、区块及可能原因列表
"TPS 下降,但不知罪魁祸首" 栈采样:正常状态与 MSPT 尖峰期间主线程时间在各插件中的占比
"哪里的农场有一千个生物?" 按实体数量排名的前几名区块;点击行即可传送至问题区块
"内存占用过高 / GC 频繁" 堆内存使用情况、填充百分比、GC 次数及耗时
"内存中加载了太多区块" 各世界已加载的区块数量

工作原理

  1. 监控 (/vca enable) — 定期收集指标(间隔在 config.yml 中设置,默认约 5 秒)。禁用时(/vca disable),收集停止;状态保存于 state.yml,重启后恢复。
  2. 分析 (/vca profile start) — 独立模式:异步采集主线程的栈快照。样本分为“MSPT 尖峰”和“正常”两类以便对比。不会随监控自动启动。
  3. 报告生成 (/vca report) — 基于累积数据和配置中的阈值,生成报告:包含 OK / 警告 / 严重状态、原因分析及建议。

默认情况下,首次安装时监控功能为禁用状态,以避免影响性能,直到管理员显式启用。

功能特性

TPS 和 MSPT

  • 1、5 和 15 分钟的 TPS;当前 MSPT(每刻毫秒数)。
  • 与 tps-warning / tps-critical 和 mspt-warning / mspt-critical 阈值进行比较。

实体

  • 按世界和类型统计(简要报告中显示前 5 种类型)。
  • 过载最严重的区块(entities-per-chunk-warning / critical 阈值)。
  • 当实体总数 > 5000 时,统计地面掉落物(ITEM)。

区块

  • 整体及各世界的已加载区块数量。
  • 出于性能考虑,代码中禁用了漏斗和红石块的计数。

内存和 CPU

  • 堆内存使用量(MB 和 %)、GC 统计信息。
  • 进程负载平均值(若操作系统支持)及核心数。

插件分析

独立的栈采样模式:/vca report 显示在卡顿期间和平稳时段主线程上正在运行什么。

建议

检测到问题时自动生成提示:清理掉落物、检查热点区域的农场、降低视距、增加 RAM 等。

权限

权限 默认值 用途
vcanalyser.admin op 所有插件命令

命令

别名:/vcanalyser, /vca。

命令 描述
/vca 帮助
/vca enable / on 启用监控
/vca disable / off 禁用监控(分析也会停止)
/vca status 监控和分析状态
/vca report 完整报告(需启用监控)
/vca tps 仅 TPS 和 MSPT
/vca entities 按世界统计实体及前 10 名区块
/vca chunks 按世界统计已加载区块
/vca memory 内存和 GC 信息
/vca profile start 开始栈采样
/vca profile stop 停止分析并重置收集的样本
/vca tp <world> <chunkX> <chunkZ> 传送到区块中心(仅限玩家)
/vca language <ru|en> 更改消息语言
/vca language 显示当前语言
/vca reload 重载 config.yml 和本地化文件
Ru
Проблема Что делает VCAnalyser
«Сервер лагает, непонятно почему» Сводный отчёт: TPS/MSPT, память, CPU, сущности, чанки, список возможных причин
«TPS падает, но не знаю виновника» Stack sampling: доля времени главного потока по плагинам при норме и при просадках MSPT
«Где ферма с тысячей мобов?» Топ чанков по числу сущностей; клик по строке — телепорт в проблемный чанк
«Жрёт память / GC» Heap, процент заполнения, счётчик и время сборок мусора
«Много чанков в памяти» Число загруженных чанков по мирам

Как это устроено

  1. Мониторинг (/vca enable) — периодический сбор метрик (интервал задаётся в config.yml, по умолчанию раз в ~5 секунд). При выключении (/vca disable) сбор останавливается; состояние сохраняется в state.yml и восстанавливается после рестарта.
  2. Профилирование (/vca profile start) — отдельный режим: асинхронно снимаются снимки стека главного потока. Сэмплы делятся на «просадка MSPT» и «норма» для сравнения. Не включается автоматически вместе с мониторингом.
  3. Анализ (/vca report) — на основе накопленных данных и порогов из конфига строит отчёт: статусы OK / предупреждение / критично, причины и рекомендации.

По умолчанию при первой установке мониторинг выключен, чтобы не влиять на производительность, пока админ явно не включит его.

Возможности

TPS и MSPT

  • TPS за 1, 5 и 15 минут; текущий MSPT (миллисекунды на тик).
  • Сравнение с порогами tps-warning / tps-critical и mspt-warning / mspt-critical.

Сущности

  • Подсчёт по мирам и по типам (топ-5 типов в кратком отчёте).
  • Топ перегруженных чанков (пороги entities-per-chunk-warning / critical).
  • Учёт дропа на земле (ITEM) при общем числе сущностей > 5000.

Чанки

  • Количество загруженных чанков всего и по мирам.
  • Подсчёт хопперов и редстоун-блоков отключён в коде ради производительности.

Память и CPU

  • Использование heap (МБ и %), статистика GC.
  • Load average процесса (если доступен на ОС) и число ядер.

Профилирование плагинов

Отдельный режим stack sampling: в /vca report показывается, что выполнялось на главном потоке во время лагов и в спокойные моменты..

Рекомендации

Автоматические подсказки при обнаружении проблем: очистка дропа, проверка ферм в горячих чанках, снижение view-distance, увеличение RAM и т.д.

Права и доступ

Право По умолчанию Назначение
vcanalyser.admin op Все команды плагина

命令

别名:/vcanalyser, /vca。

命令 描述
/vca 帮助信息
/vca enable / on 启用监控
/vca disable / off 禁用监控(同时停止分析)
/vca status 查看监控与分析的状态
/vca report 生成完整报告(需已启用监控)
/vca tps 仅显示 TPS 和 MSPT
/vca entities 按世界列出实体及前10个区块的统计
/vca chunks 按世界列出已加载的区块

| /vca memory | 内存与垃圾回收(GC) | | /vca profile start | 开始堆栈采样 | | /vca profile stop | 停止分析并清除已收集的样本 | | /vca tp <世界> <区块X> <区块Z> | 传送至区块中心(仅限玩家) | | /vca language <ru\|en> | 切换消息语言 | | /vca language | 显示当前语言 |

| /vca reload | 重新加载 config.yml 和本地化文件 |

好的,请提供需要翻译的文本内容。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源