Sorun Giderme

Sorun Giderme Kılavuzu

GalataJ kullanırken karşılaşılan yaygın sorunların çözümleri.

CLI Sorunları

CLI Bulunamadı

Hata: CLI not found veya galataj: command not found

Çözümler:

1. CLI’nin derlendiğini doğrulayın
2. PATH’e ekleyin - Kurulum Kılavuzu’na bakın
3. Sistem özelliği ayarlayın: -Dgalataj.cli.path=C:\path\to\galataj.exe

Controller Başlamıyor

Çözümler:

1. Portların müsait olup olmadığını kontrol edin
2. Farklı portlar kullanın: galataj controller start --port 8888
3. Java kurulumunu kontrol edin: java -version
4. Sistem kontrolü çalıştırın: galataj doctor

JVM Bulunamadı

Çözümler:

1. Tüm JVM’leri listeleyin: galataj jvms
2. Java süreçlerini kontrol edin: jps -l -v
3. JVM’in çalıştığını doğrulayın

Agent Sorunları

Agent Bağlanmıyor

1. Controller host/port’u kontrol edin
2. Ağ bağlantısını test edin
3. Firewall kurallarını kontrol edin

Metrik Toplanmıyor

1. Paket filtresini kontrol edin
2. Flush aralığını kontrol edin: -Dprofiler.flush.interval.ms=1000
3. Controller loglarını kontrol edin

Yüksek Overhead

1. Flush aralığını artırın: -Dprofiler.flush.interval.ms=5000
2. CPU zamanlayıcısı kullanın: -Dprofiler.timer=cpu
3. Paket filtresini daraltın

Docker Sorunları

Konteyner Görünmüyor

1. Agent yapılandırmasını kontrol edin
2. Controller erişilebilirliğini doğrulayın
3. Ağı kontrol edin: host.docker.internal kullanın
4. Konteyner loglarını kontrol edin

Sistem Sağlık Kontrolü

Kapsamlı sistem kontrolü çalıştırın:

galataj doctor

Yardım Alma

Sorunlar devam ederse:

1. Logları kontrol edin:

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

2. Teşhis çalıştırın:

   galataj doctor
   galataj status

3. Sorun bildirin:

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

Sonraki Adımlar

• Yapılandırma Kılavuzu’nu okuyun
• CLI Referansı’na bakın