Integración con IDE Basado en VS Code

¡También funciona con Cursor y Windsurf!

Esta guía aplica para VS Code, Cursor y Windsurf - todos usan la misma extensión ya que están construidos sobre VS Code.

---

Instalación

1. Abra Extensions (Ctrl+Shift+X)
2. Busque “GalataJ”
3. Haga clic en Install

Requisitos

• VS Code 1.80 o posterior
• Java JDK 11+ para su aplicación

---

Iniciar el Perfilado

1. Ejecute su aplicación Java
2. Abra la Paleta de Comandos (Ctrl+Shift+P)
3. Ejecute “GalataJ: Start Profiling”
4. Seleccione la JVM de la lista

La extensión maneja todo automáticamente:

• ✅ Inicia el controlador
• ✅ Descubre las JVMs en ejecución
• ✅ Adjunta el agente del perfilador

---

Ver Métricas Inline

Las métricas de rendimiento aparecen directamente sobre sus métodos:

Métricas mostradas:

• Tiempo de ejecución - Tiempo promedio y máximo
• Conteo de llamadas - Número de invocaciones
• Memoria - Asignaciones por llamada
• Tendencia - Indicador de cambio de rendimiento

Hover para Detalles

Pase el cursor sobre cualquier método para ver métricas detalladas:

---

Panel de GalataJ

Haga clic en el icono de GalataJ en la barra lateral para abrir el panel:

Características del panel:

• Ver todos los métodos perfilados
• Ordenar por tiempo de ejecución, conteo de llamadas o tendencia
• Filtrar por paquete o clase
• Clic para navegar al código fuente del método
• Indicador de estado de conexión

---

Detener el Perfilado

Abra la Paleta de Comandos (Ctrl+Shift+P) y ejecute “GalataJ: Stop Profiling”.

---

Entender las Métricas

Tiempo de Ejecución

Avg = promedio acumulativo desde que inició el perfilado
Max = tiempo más alto en la ventana reciente

Tendencia

↑ Positivo = haciéndose más lento
↓ Negativo = haciéndose más rápido

Conteo de Llamadas

Total de invocaciones desde que inició el perfilado

Asignaciones

Memoria asignada por llamada de método

---

Configuración de la Extensión

Abra File → Preferences → Settings y busque “GalataJ”:

Configuración	Descripción
galataj.cliPath	Ruta a la CLI (si no está en PATH)
galataj.autoStart	Auto-iniciar controlador
galataj.showInlineHints	Habilitar/deshabilitar indicaciones inline

---

Solución de Problemas

¿La JVM No Aparece?

Asegúrese de que su aplicación Java esté ejecutándose, luego intente “GalataJ: Refresh JVMs” desde la Paleta de Comandos. Si aún no aparece, ejecute galataj doctor en la terminal.

Problema	Solución
No aparecen métricas	Verifique que la barra de estado muestre “GalataJ: Connected”
Las métricas no se actualizan	Intente “GalataJ: Restart Profiling”
La extensión no se activa	Recargue la ventana de VS Code

Para más ayuda, consulte la Guía de Solución de Problemas.

---

Próximos Pasos

• Integración con IntelliJ - Use GalataJ en IntelliJ
• Perfilado en Docker - Perfile aplicaciones en contenedores
• Configuración - Personalice la configuración