Panneau Historique

Fonctionnalité Pro

Les fonctionnalités de gestion de session (sauvegarde, comparaison, export) nécessitent une licence Pro. Le niveau gratuit permet 1 sauvegarde de session par jour.

Qu’est-ce que le Panneau Historique ?

Le Panneau Historique vous permet de sauvegarder des sessions de profilage, de les comparer à des baselines et d’exporter des données pour analyse. C’est essentiel pour suivre les performances dans le temps et détecter les régressions.

Ouvrir le Panneau Historique

IntelliJ IDEA

Ouvrez la fenêtre d’outils Profiler (panneau du bas)
Cliquez sur l’onglet History

VS Code / Cursor / Windsurf

Cliquez sur l’icône GalataJ dans la barre latérale
Développez la section Session History

Sauvegarder une Session

Sauvegardez vos données de profilage actuelles pour les comparer plus tard ou les exporter pour analyse.

Comment Sauvegarder

Pendant que le profilage est actif, cliquez sur le bouton Sauvegarder Session
Entrez un nom descriptif (ex. “Avant optimisation”, “version v2.1.0”)
Optionnellement ajoutez des tags pour le filtrage
Cliquez sur Sauvegarder

Ce qui est Sauvegardé

Données	Description
Métriques de méthodes	Temps CPU Moy/Max, nombre d’appels, allocations
Info de contexte	Endpoints HTTP, contrôleurs Spring, requêtes DB
Info JVM	Version Java, taille du heap, statistiques GC
Horodatage	Quand la session a été capturée

Qu’est-ce qu’une Baseline ?

Une baseline est une session de référence contre laquelle vous comparez votre performance actuelle (en direct). Elle représente votre état “connu comme bon”.

Définir une Baseline

Dans le Panneau Historique, trouvez la session que vous voulez comme baseline
Clic droit → Définir comme Baseline (ou cliquez sur l’icône ⭐)
La session baseline sera marquée d’une étoile

Comparer les Sessions

Comparez deux sessions quelconques pour voir ce qui a changé - parfait pour détecter les régressions ou vérifier les optimisations.

Comprendre les Résultats de Comparaison

Colonne	Description
Méthode	Nom de classe et méthode
Baseline	Métriques de la session baseline
Actuel	Métriques de la session comparée
Delta	Différence (+ plus lent, - plus rapide)
Tendance	↑ Régression, ↓ Amélioration, = Inchangé

Code Couleur

🟢 Vert - Performance améliorée (plus rapide, moins de mémoire)
🔴 Rouge - Performance dégradée (plus lent, plus de mémoire)
⚪ Gris - Pas de changement significatif

Exporter les Sessions

Exportez vos données de profilage pour la documentation, le partage ou l’analyse externe.

Formats d’Export

Format	Meilleur Pour
JSON	Analyse programmatique, intégration CI/CD
CSV	Analyse tableur, Excel/Google Sheets
HTML	Rapports lisibles, partage avec l’équipe

Export via CLI

# Exporter la dernière session
galataj export --format json --output ./profiling-data.json

# Exporter une session spécifique
galataj export --session-id abc123 --format html --output ./report.html

# Exporter une comparaison
galataj export --compare --session1 abc123 --session2 def456 --format csv

Bonnes Pratiques

Nommez les Sessions de Façon Descriptive

Utilisez des noms comme “v2.1.0-avant-fix-cache” au lieu de “session1”

Sauvegardez aux Jalons

Sauvegardez des sessions avant/après les changements majeurs, versions et optimisations

Utilisez des Tags

Ajoutez des tags comme “production”, “staging”, “feature-x” pour un filtrage facile

Mises à Jour Régulières de Baseline

Mettez à jour votre baseline après des améliorations de performance vérifiées

Dépannage

Problème	Solution
Impossible de sauvegarder la session	Vérifiez la licence Pro : `galataj license status`
Les sessions n’apparaissent pas	Actualisez le Panneau Historique
L’export échoue	Vérifiez l’espace disque et les permissions d’écriture
La comparaison ne montre pas de données	Assurez-vous que les deux sessions ont des méthodes communes

Prochaines Étapes

Intégration IA - Utilisez l’IA pour analyser vos données de profilage
Configuration - Personnalisez les paramètres de session
Référence CLI - Gestion de session en ligne de commande