Flare (Spark for 1.12.2)

Основан на spark; flare — это профилировщик производительности и отладчик для окружений Forge & Cleanroom на 1.12.2.

Что делает flare?

flare состоит из следующих отдельных компонентов:

• Профилировщик CPU: диагностика проблем с производительностью.
• Инспекция памяти: диагностика проблем с памятью.
• Отчёт о состоянии сервера: отслеживание общего состояния сервера.

✨ Профилировщик CPU

Профилировщик flare можно использовать для диагностики проблем с производительностью: «лагов», низкого тикрейта, высокой нагрузки на CPU и т. д.

Он:

• Лёгкий — можно запускать на боевом сервере с минимальным влиянием.
• Простой в использовании — не требует настройки или подготовки, достаточно установить плагин/мод.
• Быстро выдаёт результаты — запуска всего на ~30 секунд достаточно, чтобы получить полезную информацию о проблемных местах производительности.
• Настраиваемый — можно настроить на конкретные потоки, выборку с определённым интервалом, запись только «лагующих» периодов и т. д.
• Очень удобный для чтения — простая древовидная структура облегчает анализ и интерпретацию. Просмотрщик также может применять маппинги деобфускации.

Он работает путём выборки статистических данных об активности системы и построения графа вызовов на основе этих данных. Затем граф вызовов отображается в онлайн-просмотрщике для дальнейшего анализа пользователем.

Существует два разных движка профилирования:

• Нативный AsyncGetCallTrace + perf_events — использует async-profiler (доступно только на системах Linux x86_64)
• Встроенный Java ThreadMXBean — улучшенная версия популярного профилировщика WarmRoast от sk89q.

✨ Инспекция памяти

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

• Сводка по куче — снять и проанализировать базовый снимок памяти сервера

  • Простой вид кучи JVM: использование памяти и количество экземпляров для каждого класса
  • Не предназначено для полной замены специализированных инструментов анализа памяти. (см. следующий пункт)

• Дамп кучи — снять полный (HPROF) снимок памяти сервера

  • Сохраняет (и опционально сжимает) полный снимок кучи JVM.
  • Этот снимок затем можно изучить с помощью обычных инструментов анализа.

• Мониторинг GC — отслеживание активности сборки мусора на сервере

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

✨ Отчёт о состоянии сервера

flare может сообщать ряд метрик, обобщающих общее состояние сервера.

Эти метрики включают:

• TPS — тиков в секунду, с более высокой точностью, чем показывает команда /tps
• Длительность тиков — сколько времени занимает каждый тик (мин., макс. и среднее)
• Использование CPU — сколько CPU использует процесс и система в целом
• Использование памяти — сколько памяти использует процесс
• Использование диска — сколько дискового пространства свободно/используется системой

Помимо предоставления средних значений тикрейта, flare также может отслеживать отдельные тики — отправляя отчёт всякий раз, когда длительность одного тика превышает определённый порог. Это можно использовать для выявления тенденций и характера проблем с производительностью относительно других системных или игровых событий.

Для сравнения flare, WarmRoast, Minecraft timings и других профилировщиков см. эту страницу в оригинальной документации spark.

Как использовать flare?

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

Лицензия

flare — бесплатный проект с открытым исходным кодом. Он распространяется на условиях лицензии GNU GPLv3. Подробнее см. LICENSE.

Подмодуль flare API распространяется на условиях более либеральной лицензии MIT. Подробнее см. flare-api/LICENSE.

flare — форк spark, который также был лицензирован под GPLv3.