Fehlerbehebung

Fehlerbehebungshandbuch

Lösungen für häufige Probleme bei der Verwendung von GalataJ.

CLI-Probleme

CLI nicht gefunden

Fehler: CLI not found oder galataj: command not found

Lösungen:

1. Verifizieren Sie, dass CLI gebaut ist
2. Zum PATH hinzufügen - siehe Installationsanleitung
3. Systemeigenschaft setzen: -Dgalataj.cli.path=C:\path\to\galataj.exe

Controller startet nicht

Lösungen:

1. Prüfen, ob Ports verfügbar sind
2. Andere Ports verwenden: galataj controller start --port 8888
3. Java-Installation prüfen: java -version
4. Systemcheck ausführen: galataj doctor

JVM nicht gefunden

Lösungen:

1. Alle JVMs auflisten: galataj jvms
2. Java-Prozesse prüfen: jps -l -v
3. Verifizieren, dass JVM läuft

Agent-Probleme

Agent verbindet sich nicht

1. Controller-Host/Port prüfen
2. Netzwerkkonnektivität testen
3. Firewall-Regeln prüfen

Keine Metriken gesammelt

1. Paketfilter prüfen
2. Flush-Intervall prüfen: -Dprofiler.flush.interval.ms=1000
3. Controller-Logs prüfen

Hoher Overhead

1. Flush-Intervall erhöhen: -Dprofiler.flush.interval.ms=5000
2. CPU-Timer verwenden: -Dprofiler.timer=cpu
3. Paketfilter eingrenzen

Docker-Probleme

Container erscheint nicht

1. Agent-Konfiguration prüfen
2. Controller-Erreichbarkeit verifizieren
3. Netzwerk prüfen: host.docker.internal verwenden
4. Container-Logs prüfen

System-Gesundheitscheck

Umfassenden Systemcheck ausführen:

galataj doctor

Hilfe bekommen

Falls Probleme bestehen:

1. Logs prüfen:

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

2. Diagnostik ausführen:

   galataj doctor
   galataj status

3. Issue melden:

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

Nächste Schritte

• Konfigurationshandbuch lesen
• CLI-Referenz anschauen