Solución de Problemas

Guía de Solución de Problemas

Soluciones a problemas comunes al usar GalataJ.

Problemas de CLI

CLI No Encontrada

Error: CLI not found o galataj: command not found

Soluciones:

1. Verifique que la CLI esté construida
2. Agregue al PATH - vea Guía de Instalación
3. Establezca propiedad del sistema: -Dgalataj.cli.path=C:\path\to\galataj.exe

El Controlador No Inicia

Soluciones:

1. Verifique que los puertos estén disponibles
2. Use diferentes puertos: galataj controller start --port 8888
3. Verifique la instalación de Java: java -version
4. Ejecute verificación del sistema: galataj doctor

JVM No Encontrada

Soluciones:

1. Liste todas las JVMs: galataj jvms
2. Verifique procesos Java: jps -l -v
3. Verifique que la JVM esté ejecutándose

Problemas del Agente

El Agente No Se Conecta

1. Verifique host/puerto del controlador
2. Pruebe conectividad de red
3. Verifique reglas del firewall

No Se Recopilan Métricas

1. Verifique filtro de paquete
2. Verifique intervalo de flush: -Dprofiler.flush.interval.ms=1000
3. Revise logs del controlador

Alto Overhead

1. Aumente intervalo de flush: -Dprofiler.flush.interval.ms=5000
2. Use temporizador CPU: -Dprofiler.timer=cpu
3. Reduzca filtro de paquete

Problemas de Docker

El Contenedor No Aparece

1. Verifique configuración del agente
2. Verifique accesibilidad del controlador
3. Verifique red: use host.docker.internal
4. Revise logs del contenedor

Verificación de Salud del Sistema

Ejecute verificación completa del sistema:

galataj doctor

Obtener Ayuda

Si los problemas persisten:

1. Revise logs:

   • Controlador: logs/profiler-controller.log
   • IntelliJ: Help → Show Log in Finder

2. Ejecute diagnósticos:

   galataj doctor
   galataj status

3. Reporte problema:

   • GitHub Issues: https://github.com/yyusufaslan/tiny-inline-profiler/issues

Próximos Pasos

• Lea la Guía de Configuración
• Consulte la Referencia CLI