Dépannage

Guide de Dépannage

Solutions aux problèmes courants lors de l’utilisation de GalataJ.

Problèmes CLI

CLI Non Trouvée

Erreur : CLI not found ou galataj: command not found

Solutions :

1. Vérifiez que la CLI est compilée
2. Ajoutez au PATH - voir Guide d’Installation
3. Définissez la propriété système : -Dgalataj.cli.path=C:\path\to\galataj.exe

Le Contrôleur Ne Démarre Pas

Solutions :

1. Vérifiez que les ports sont disponibles
2. Utilisez des ports différents : galataj controller start --port 8888
3. Vérifiez l’installation Java : java -version
4. Exécutez la vérification système : galataj doctor

JVM Non Trouvée

Solutions :

1. Listez toutes les JVMs : galataj jvms
2. Vérifiez les processus Java : jps -l -v
3. Vérifiez que la JVM fonctionne

Problèmes d’Agent

L’Agent Ne Se Connecte Pas

1. Vérifiez l’hôte/port du contrôleur
2. Testez la connectivité réseau
3. Vérifiez les règles du pare-feu

Pas de Métriques Collectées

1. Vérifiez le filtre de package
2. Vérifiez l’intervalle de flush : -Dprofiler.flush.interval.ms=1000
3. Consultez les logs du contrôleur

Overhead Élevé

1. Augmentez l’intervalle de flush : -Dprofiler.flush.interval.ms=5000
2. Utilisez le timer CPU : -Dprofiler.timer=cpu
3. Réduisez le filtre de package

Problèmes Docker

Le Conteneur N’Apparaît Pas

1. Vérifiez la configuration de l’agent
2. Vérifiez l’accessibilité du contrôleur
3. Vérifiez le réseau : utilisez host.docker.internal
4. Consultez les logs du conteneur

Vérification de Santé du Système

Exécutez une vérification complète du système :

galataj doctor

Obtenir de l’Aide

Si les problèmes persistent :

1. Consultez les logs :

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

2. Exécutez les diagnostics :

   galataj doctor
   galataj status

3. Signalez le problème :

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

Prochaines Étapes

• Lisez le Guide de Configuration
• Consultez la Référence CLI