Contrôle des transactions
La page Contrôle des transactions repère les méthodes @Transactional qui monopolisent une connexion à la base de données plus longtemps que nécessaire : appels réseau bloquants, requêtes N+1 et pagination en mémoire dans la transaction. Pour chaque problème, elle indique où il se produit afin que vous puissiez retrouver l’endroit dans le code.

Contrôle des transactions dans l’interface Axelix
Tant qu’une transaction est ouverte, elle conserve une connexion à la base de données issue du pool. Lorsque la
transaction effectue des opérations supplémentaires, comme appeler un autre service, exécuter une requête par
enregistrement ou charger une table entière pour afficher une seule page, les connexions s’épuisent et l’application
ralentit sous charge. Le code met rarement ce problème en évidence. Contrôle des transactions indique quelles méthodes
@Transactional présentent ce comportement et où exactement.
La page est en lecture seule et accessible à tous les utilisateurs authentifiés : VIEWER, EDITOR, ADMIN et SUPER_ADMIN peuvent tous l’ouvrir. Consultez Rôles et autorités pour obtenir la matrice complète des rôles et autorités.
Contenu de la page
La page répertorie toutes les méthodes @Transactional exécutées par l’instance, avec leur temps d’exécution moyen,
le plus court et le plus long, ainsi que les problèmes détectés. Un résumé en haut indique
combien de transactions présentent des problèmes et combien n’en présentent pas ; vous pouvez limiter la liste à un
seul type de problème.
Ouvrez une transaction pour voir :
- Où chaque problème s’est produit : l’URL appelée, l’entité et l’association, ou l’entité paginée en mémoire.
- Le niveau de propagation et d’isolation de la transaction.
- Le type d’accès : lecture seule ou lecture-écriture.
Lorsqu’aucune transaction ne présente de problème, la page l’indique au lieu d’afficher la liste.
Problèmes détectés
- Appel réseau bloquant : la transaction effectue un appel HTTP et conserve sa connexion en attendant la réponse.
Axelix affiche la méthode et l’URL de la requête. Actuellement, Axelix détecte les appels effectués via
RestTemplate. - Requêtes N+1 : une association à chargement paresseux est chargée avec une requête distincte pour chaque enregistrement. Axelix affiche l’entité et l’association, et ne comptabilise le problème que lorsque l’association a été chargée plusieurs fois.
- Pagination en mémoire :
Pageableest combiné avecJOIN FETCH, si bien qu’Hibernate charge l’ensemble des résultats et découpe la page en mémoire. Axelix affiche l’entité ou la table.
Fonctionnement
L’Axelix Spring Boot Starter observe chaque appel de méthode @Transactional dans l’application et mesure sa durée.
Tant que la transaction est ouverte, il enregistre les appels HTTP effectués via RestTemplate et les chargements
paresseux d’associations Hibernate, et intercepte l’avertissement Hibernate concernant la pagination en mémoire dans
les logs de l’application (Logback ou Log4j2). Aucun agent ni outil APM n’est requis.
Outils MCP
Les agents IA peuvent obtenir via MCP les requêtes N+1 et les paginations en mémoire détectées dans les transactions d’une application, pour toute l’application ou pour une classe ou une méthode. Les appels réseau bloquants ne sont pas inclus. Consultez le catalogue des outils MCP.
Propriétés
La surveillance des transactions est activée par défaut. Pour la désactiver entièrement, définissez
axelix.sbs.transaction.monitoring.enabled=false. Consultez Surveillance des
transactions
pour plus de détails.
La surveillance des transactions, et donc cette page, n’est pas disponible dans les applications réactives (WebFlux). Consultez Applications réactives (WebFlux).
Exposer l’endpoint de métadonnées
Il n’existe pas d’endpoint Actuator propre aux transactions. Les premières informations sur les transactions sont incluses dans les métadonnées d’enregistrement de l’instance, exposées via axelix-metadata lorsque Master découvre l’instance.
Pour les starters à partir de 1.3.0, Master interroge axelix-ping pour obtenir les mises à jour suivantes des transactions. Les instances auto-enregistrées transmettent ces mises à jour dans leurs heartbeats à la place. Pour les starters plus anciens, Master continue de lire les métadonnées d’enregistrement complètes.
Pour l’interrogation par Master, exposez axelix-metadata et, pour les starters à partir de 1.3.0, axelix-ping. Le starter expose automatiquement ses propres endpoints depuis 1.2.0 ; consultez Exposition des endpoints sur Axelix avant 1.2.0 pour les versions antérieures. Aucun endpoint supplémentaire propre aux transactions n’est nécessaire.
Voir aussi
Caches
La page Caches répertorie tous les caches Spring de l’application et montre l’efficacité de chacun. Vous pouvez également vider un cache ou le désactiver à l’exécution, sur une instance ou sur plusieurs à la fois.
Carte des entités
La page Carte des entités vérifie le mapping JPA de chaque entité d’une instance Spring Boot et montre les associations dont le mapping entraîne des requêtes supplémentaires : chargement eager, @ManyToMany reposant sur une List, cascade REMOVE ou ALL et @OneToMany unidirectionnel.