Solución de problemas

¿Problemas? Empieza con una comprobación de estado y luego revisa los problemas habituales siguientes.

---

Primer paso: Comprobación de estado

Empieza siempre aquí

Abre el panel Profiler y haz clic en Health. Esto diagnostica la mayoría de problemas y ofrece correcciones con un clic.

La comprobación de estado te dirá exactamente qué falla y cómo solucionarlo.

Más sobre la comprobación de estado →

---

Problemas habituales

La JVM no aparece

Síntomas: Tu aplicación Java está en ejecución pero no aparece en la lista de JVMs.

Soluciones:

1. Haz clic en Actualizar en el panel del profiler
2. Asegúrate de que tu aplicación Java está realmente en ejecución
3. Ejecuta una Comprobación de estado — puede que el controlador no esté en ejecución

---

No aparecen métricas

Síntomas: El profiling está activo pero no aparecen métricas.

Soluciones:

1. Comprueba la barra de estado — debería decir “Profiling”
2. Asegúrate de que tu código coincide con el filtro de paquetes
3. Abre archivos del paquete perfilado
4. Espera unos segundos a que lleguen los datos

---

Pistas en línea no visibles

Para IntelliJ:

1. Ve a Configuración → Editor → Inlay Hints
2. Busca Code Vision → GalataJ
3. Asegúrate de que está activado
4. Reinicia el IDE si hace falta

Para VS Code:

1. Comprueba que el profiling está activo (barra de estado)
2. Abre un archivo del paquete perfilado
3. Prueba a recargar la ventana

---

El controlador no arranca

Soluciones:

1. Ejecuta Comprobación de estado y haz clic en Fix junto al error
2. Reinicia tu IDE
3. Asegúrate de que ninguna otra aplicación usa los puertos necesarios

---

El profiling no arranca

Soluciones:

1. Ejecuta primero Comprobación de estado
2. Asegúrate de que hay una JVM seleccionada
3. Haz clic en Actualizar para actualizar la lista de JVMs
4. Reinicia el IDE

---

El plugin no carga

Soluciones:

1. Reinicia el IDE después de instalar
2. Comprueba que el plugin está activado en Configuración → Plugins
3. Asegúrate de que tu versión del IDE es compatible:
   • IntelliJ IDEA 2024.1 o posterior
   • VS Code 1.80 o posterior

---

Reinstalación completa

Si nada más funciona, puedes hacer una reinstalación completa para empezar de cero.

Paso 1: Desinstalar la extensión

IntelliJ: Configuración → Plugins → Busca GalataJ → Desinstalar

VS Code: Barra lateral de extensiones → Busca GalataJ → Desinstalar

Paso 2: Detener el controlador

Abre una terminal y ejecuta:

galataj controller stop

Paso 3: Borrar la configuración

Borra la carpeta .galataj en tu directorio de usuario:

Windows:

Remove-Item -Recurse -Force "$env:USERPROFILE\.galataj"

macOS / Linux:

rm -rf ~/.galataj

Paso 4: Reinstalar

1. Instala la extensión desde el marketplace
2. Abre la extensión — el Asistente de configuración te guiará
3. Activa tu licencia si tienes una

---

¿Sigue sin funcionar?

Comprobar estado

La comprobación de estado detecta la mayoría de problemas automáticamente

Ejecutar comprobación →

Reportar un fallo

Abre un issue en GitHub con detalles de tu problema

Abrir issue →

---

Resumen de soluciones rápidas

Problema	Solución rápida
JVM no encontrada	Haz clic en Actualizar en el panel
Sin métricas	Comprueba que el filtro de paquetes coincide con tu código
Pistas no visibles	Configuración → Inlay Hints → GalataJ
Problemas del controlador	Ejecuta Comprobación de estado → Haz clic en Fix
Problemas generales	Reinicia el IDE
Nada funciona	Reinstalación completa