Flare

Flare es un plugin de diagnóstico y perfilado de rendimiento diseñado para servidores de Hytale. Se centra en recopilar datos que pueden ayudarte a determinar dónde está disminuyendo el rendimiento. Flare expone comandos bajo demanda para el uso de memoria heap, pausas de GC, conteos de hilos, TPS, carga de CPU, estadísticas del mundo y tráfico de red.

Cuando necesites obtener información más profunda, puedes iniciar una sesión de perfilado y Flare capturará instantáneas periódicas de todos los datos mencionados anteriormente junto con muestras de alta frecuencia de la pila de ejecución actual. Estos perfiles se guardan como archivos .flarereport que pueden ser utilizados para su inspección.

Actualmente, no hay una forma sencilla de profundizar en estos informes, ya que son binarios protobuf comprimidos con zstd, pero existe un script de Python que puede convertirlos a JSON. Eventualmente proporcionaremos un visor para los informes.

Flare también captura tanto un preámbulo como un postámbulo de las configuraciones del servidor y del mundo, así como diversos datos del entorno. Estos preámbulos permiten descubrir cambios en la configuración durante una sesión de perfilado.

El objetivo de Flare es capturar datos detallados, hacerlo sin afectar al rendimiento y exponer métricas que puedan ayudar a los jugadores a ajustar sus servidores.

Comandos

El plugin proporciona un comando /flare con los siguientes subcomandos:

/flare o /flare status – Muestra una instantánea de las métricas de rendimiento actuales
/flare info – Muestra información sobre el plugin
/flare heap – Muestra el estado detallado de la memoria heap
/flare gc – Muestra estadísticas de recolección de basura
/flare threads – Muestra información sobre hilos y detección de interbloqueos
/flare tps – Muestra información de TPS
/flare cpu – Muestra el uso de CPU (si está disponible)
/flare network – Muestra estadísticas de tráfico de red
/flare profile start [timeoutSeconds] – Inicia una sesión de perfilado (se detiene automáticamente después de N segundos)
/flare profile stop – Detiene la sesión de perfilado actual
/flare profile status – Muestra el estado de la sesión de perfilado

Perfilado

Para iniciar el perfilado:

/flare profile start

Para detenerse automáticamente después de 30 segundos:

/flare profile start 30

Esto comenzará a recopilar instantáneas de rendimiento en el intervalo configurado (por defecto: 1 segundo). El perfilador se detendrá automáticamente cuando:

Se alcance la duración máxima (por defecto: 1 hora)
Se alcancen las instantáneas máximas (por defecto: 3600)
Lo detengas manualmente con /flare profile stop

Los datos de perfilado se guardan como archivos .flarereport en mods/Flare/profiles/ con nombres de archivo como profile_YYYY-MM-DD_HH-MM-SS.flarereport. Los informes son cargas protobuf comprimidas con zstd.