Профайлер spark: как найти, что тормозит сервер

Коротко: дождитесь лагов и выполните /spark profiler start --timeout 600. Через 10 минут spark пришлёт ссылку на отчёт. В нём откройте поток «Server thread» и идите по самым большим процентам, а вид «Sources» покажет отдельное дерево для каждого плагина. Для редких фризов добавьте --only-ticks-over 100 — в отчёт попадут только тики дольше 100 мс.

Установка: на Paper уже есть#

Начиная с 1.21 Paper поставляется со встроенным spark, ставить jar не нужно — команда /spark работает сразу. Им управляет раздел spark в config/paper-global.yml: enabled: true включает встроенный spark, а enable-immediately: false значит, что он запускается после строки Done в консоли. Чтобы профилировать сам запуск сервера, поставьте enable-immediately: true.

• Нужна версия новее встроенной. Положите jar spark в plugins/ и добавьте в команду запуска -Dpaper.preferSparkPlugin=true.
• Другие серверы. Скачайте jar со страницы загрузок spark и положите в папку plugins или mods, затем перезапустите сервер.
• Прокси. На Velocity команда — /sparkv, на BungeeCord — /sparkb.
• Права. Общее право spark или отдельные: spark.profiler, spark.health, spark.tps, spark.gc, spark.heapsummary. Операторам доступно и так.

Главные команды#

Профайлер и его флаги#

/spark profiler start --timeout 600
/spark profiler start --only-ticks-over 100 --timeout 600
/spark profiler start --thread * --timeout 600
/spark profiler open

Профиль полезен, только пока проблема происходит: так пишет и документация Paper. Снимайте его в пиковый онлайн или когда игроки жалуются, а не на пустом сервере. На Linux и macOS (x86_64 и arm64) spark использует движок async-profiler — он точнее Java-сэмплера. В контейнерах вроде Pterodactyl ему может понадобиться пакет libstdc++.

Редкие фризы: tickmonitor и --only-ticks-over#

Обычный профиль усредняет данные: один тик на 300 мс тонет среди тысяч нормальных. Документация spark предлагает двухшаговый способ.

1. 1

   Поймайте фриз

   /spark tickmonitor --threshold-tick 50 сообщит о каждом тике дольше 50 мс — с этого момента сервер начинает отставать. Без флагов монитор сообщает о тиках вдвое дольше среднего.

2. 2

   Оцените длительность

   Посмотрите, сколько длятся лаговые тики, и сопоставьте время с тем, что происходило в игре.

3. 3

   Снимите профиль только фризов

   /spark profiler start --only-ticks-over 100. Порог должен быть ниже длительности лаговых тиков; spark советует значение от 50 до 100 мс.

Как читать отчёт#

1. 1

   Выберите поток

   Вверху — список потоков. Главный — «Server thread»: он считает тик. Поток всегда показан как 100 %, ниже — доли его времени.

2. 2

   Отделите сон от работы

   Время в ожидании следующего тика (waitForNextTick, sleep) — это хорошо: у сервера есть запас. По документации spark, меньше 20 % сна — сервер работает на пределе, меньше 5 % — почти наверняка лагает.

3. 3

   Идите по процентам

   Раскрывайте узлы с наибольшей долей: тик миров, сущности, задачи планировщика плагинов. Время в миллисекундах видно при наведении.

4. 4

   Включите «Sources»

   Вид «Sources» строит отдельное дерево для каждого плагина: сразу видно, какой плагин сколько забирает у тика.

Память и сборка мусора#

/spark health show --memory выводит в консоль подробности о памяти JVM, /spark gc — историю сборок мусора. Если память растёт и не освобождается, /spark heapsummary покажет, какие классы занимают кучу: по именам пакетов обычно видно, чей это плагин. /spark heapdump пишет полный снимок .hprof — он большой, держите место на диске. Сколько памяти давать серверу — в статье сколько RAM нужно, какие флаги ставить сборщику — в статье флаги JVM.

Как поделиться отчётом#

Ссылку на отчёт можно свободно отправить разработчику плагина или в поддержку: документация Paper просит приносить отчёт spark в канал #paper-help своего Discord. Если не хотите загружать профиль на сайт spark, остановите профайлер с --save-to-file. А готовый список того, что обычно оказывается причиной лагов, — в статьях почему лагает сервер и оптимизация Paper.

Проверьте античит в профиле#

Профиль spark — честный способ проверить любой плагин, в том числе античит: найдите его в виде «Sources» и посмотрите долю в «Server thread». DGuard — лучший античит для современного сервера Minecraft — считает проверки в сетевых потоках, поэтому на основном потоке он занимает 0,03 % одного ядра. Работу в сетевых потоках покажет профиль с --thread *, а время самих проверок — команда /dguard perf. Как сравнить два античита на одном сервере — в статье нагрузка античита.

Частые вопросы#