Flare

A performance profiler built for Hytale

125.0 загрузок

Обновлён 19 дней назад

Разное Улучшение Качества Жизни Утилиты

Скачать последнюю версию (4.8 МБ)

Описание

Flare - это плагин для диагностики производительности и профилирования, созданный для серверов Hytale. Он фокусируется на сборе данных, которые могут помочь вам определить, где снижается производительность. Flare раскрывает команды по требованию для использования кучи, пауз GC, подсчета потоков, TPS, загрузки процессора, мировой статистики и сетевого трафика.

Когда вам нужно более глубокое понимание, вы можете начать сеанс профилирования, и Flare будет делать периодические снимки всех вышеперечисленных данных вместе с высокочастотными образцами текущего стека выполнения. Эти профили сохраняются как .flarereport Файлы, которые можно использовать для проверки.

В настоящее время нет простого способа копаться в этих отчетах, так как они представляют собой zstd-сжатые двоичные файлы протобуфа, но есть скрипт Python, который может конвертировать их в JSON. В конце концов, мы предоставим зрителям отчеты.

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

Цель Flare — собирать многословные данные, делать это без ущерба для производительности и раскрывать метрики, которые могут помочь игрокам настроить свои серверы.

командование

Плагин обеспечивает Вспышка командовать следующими подкомандами:

Вспышка или Статус вспышки Показать текущие показатели производительности snapshot
/flare info - Показать информацию о плагинах
Груда вспышек Показать подробный статус памяти
Вспышка гк Показать статистику сбора мусора
/flare threads - Показать информацию о потоке и обнаружении тупика
/Вспышка tps Показать информацию TPS
/flare pu Показать использование CPU (если доступно)
/Вспышка сети Показать статистику сетевого трафика
/flare profile start [второй тайм-аут] Начните сеанс профилирования (автостоп через N секунд)
/Вспышка профиля стоп - Остановите текущую сессию профилирования
Статус профиля вспышки - Показать статус сеанса профилирования

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

Для начала профилирования:

/Вспышка профиль старт

Автоматическая остановка через 30 секунд:

/Вспышка начинается 30

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

Максимальная продолжительность (по умолчанию: 1 час)
Достигается максимальное количество снимков (по умолчанию: 3600)
Вы вручную останавливаете его /Вспышка профиля стоп

Данные профиля сохраняются как .flarereport файлы в Моды/Вспышки/Профили/ Файловые имена как профиль_YYYY-MM-DD_HH-MM-SS.flarereport. Отчеты представляют собой сжатые zstd полезные нагрузки протобуфа.

Показать оригинальное описание (English)

Flare is a performance diagnostics and profiling plugin built for Hytale servers. It focuses on gathering data that can assist you with determining where performance is dropping. Flare exposes on-demand commands for heap usage, GC pauses, thread counts, TPS, CPU load, world stats, and network traffic.

When you need deeper insights you can start a profiling session and Flare will capture periodic snapshots of all the above data alongside high-frequency samples of the current executation stack. These profiles are saved as .flarereport files which can be used for inspection.

Currently there's no easy way of digging into these reports, as they're zstd-compressed protobuf binaries, but there is a Python script that can convert them into JSON. Eventually we'll provide a viewer for reports.

Flare also captures both a preamble and a postamble of the server and world configs, as well as various envrionment data. These preambles allow for the discovery of configuration changes during a profile session.

Flare's goal is to capture verbose data, do so without hurting performance, and expose metrics that can help players tune their servers.

Commands

The plugin provides a /flare command with the following subcommands:

/flare or /flare status - Show current performance metrics snapshot
/flare info - Show plugin information
/flare heap - Show detailed heap memory status
/flare gc - Show garbage collection statistics
/flare threads - Show thread information and deadlock detection
/flare tps - Show TPS information
/flare cpu - Show CPU usage (if available)
/flare network - Show network traffic statistics
/flare profile start [timeoutSeconds] - Start a profiling session (auto-stop after N seconds)
/flare profile stop - Stop the current profiling session
/flare profile status - Show profiling session status

Profiling

To start profiling:

/flare profile start

To auto-stop after 30 seconds:

/flare profile start 30

This will begin collecting performance snapshots at the configured interval (default: 1 second). The profiler will automatically stop when:

Maximum duration is reached (default: 1 hour)
Maximum snapshots are reached (default: 3600)
You manually stop it with /flare profile stop

Profile data is saved as .flarereport files in mods/Flare/profiles/ with filenames like profile_YYYY-MM-DD_HH-MM-SS.flarereport. Reports are zstd-compressed protobuf payloads.