Panel de Historial

Función Pro

Las funciones de gestión de sesiones (guardar, comparar, exportar) requieren una licencia Pro. El nivel gratuito permite 1 guardado de sesión por día.

---

¿Qué es el Panel de Historial?

El Panel de Historial le permite guardar sesiones de perfilado, compararlas contra baselines y exportar datos para análisis. Esto es esencial para rastrear el rendimiento a lo largo del tiempo y detectar regresiones.

---

Abrir el Panel de Historial

IntelliJ IDEA

1. Abra la ventana de herramientas Profiler (panel inferior)
2. Haga clic en la pestaña History

VS Code / Cursor / Windsurf

1. Haga clic en el icono de GalataJ en la barra lateral
2. Expanda la sección Session History

---

Guardar una Sesión

Guarde sus datos de perfilado actuales para comparar más tarde o exportar para análisis.

Cómo Guardar

1. Mientras el perfilado está activo, haga clic en el botón Guardar Sesión
2. Ingrese un nombre descriptivo (ej. “Antes de optimización”, “lanzamiento v2.1.0”)
3. Opcionalmente agregue etiquetas para filtrar
4. Haga clic en Guardar

Qué se Guarda

Datos	Descripción
Métricas de métodos	Tiempo CPU Prom/Max, conteo de llamadas, asignaciones
Info de contexto	Endpoints HTTP, controladores Spring, consultas DB
Info de JVM	Versión de Java, tamaño de heap, estadísticas de GC
Marca de tiempo	Cuándo se capturó la sesión

---

¿Qué es un Baseline?

Un baseline es una sesión de referencia contra la cual compara su rendimiento actual (en vivo). Representa su estado “conocido como bueno”.

Establecer un Baseline

1. En el Panel de Historial, encuentre la sesión que desea como baseline
2. Clic derecho → Establecer como Baseline (o haga clic en el icono ⭐)
3. La sesión baseline se marcará con una estrella

---

Comparar Sesiones

Compare cualquier dos sesiones para ver qué cambió - perfecto para detectar regresiones o verificar optimizaciones.

Entender los Resultados de Comparación

Columna	Descripción
Método	Nombre de clase y método
Baseline	Métricas de la sesión baseline
Actual	Métricas de la sesión comparada
Delta	Diferencia (+ más lento, - más rápido)
Tendencia	↑ Regresión, ↓ Mejora, = Sin cambio

Codificación de Colores

• 🟢 Verde - Rendimiento mejoró (más rápido, menos memoria)
• 🔴 Rojo - Rendimiento empeoró (más lento, más memoria)
• ⚪ Gris - Sin cambio significativo

---

Exportar Sesiones

Exporte sus datos de perfilado para documentación, compartir o análisis externo.

Formatos de Exportación

Formato	Mejor Para
JSON	Análisis programático, integración CI/CD
CSV	Análisis en hojas de cálculo, Excel/Google Sheets
HTML	Reportes legibles, compartir con el equipo

Exportar vía CLI

# Exportar última sesión
galataj export --format json --output ./profiling-data.json

# Exportar sesión específica
galataj export --session-id abc123 --format html --output ./report.html

# Exportar comparación
galataj export --compare --session1 abc123 --session2 def456 --format csv

---

Mejores Prácticas

Nombre las Sesiones Descriptivamente

Use nombres como “v2.1.0-antes-arreglo-cache” en lugar de “sesion1”

Guarde en Hitos

Guarde sesiones antes/después de cambios importantes, lanzamientos y optimizaciones

Use Etiquetas

Agregue etiquetas como “producción”, “staging”, “feature-x” para filtrado fácil

Actualizaciones Regulares de Baseline

Actualice su baseline después de mejoras de rendimiento verificadas

---

Solución de Problemas

Problema	Solución
No puede guardar sesión	Verifique licencia Pro: galataj license status
Las sesiones no aparecen	Actualice el Panel de Historial
La exportación falla	Verifique espacio en disco y permisos de escritura
La comparación no muestra datos	Asegúrese de que ambas sesiones tengan métodos superpuestos

---

Próximos Pasos

• Integración con IA - Use IA para analizar sus datos de perfilado
• Configuración - Personalice configuraciones de sesión
• Referencia CLI - Gestión de sesiones por línea de comandos