Après avoir connecté une application Java exécutée sur JDK 17 à Application Real-Time Monitoring Service (ARMS), il se peut que la console ARMS n'affiche aucune donnée de supervision. Ce problème survient lorsque la version de l'agent ARMS ne prend pas en charge JDK 17, ou lorsqu'une dépendance obsolète de l'API Servlet interfère avec la logique d'instrumentation de l'agent.
Cause 1 : La version de l'agent ARMS ne prend pas en charge JDK 17
La prise en charge de JDK 17 a été introduite dans la version V2.8.3 de l'agent ARMS. Si votre agent est antérieur à la version V2.8.3, il ne peut pas instrumenter les applications s'exécutant sur JDK 17 et aucune donnée de supervision n'est collectée.
Exigences de version
| Framework d'application | Version minimale de l'agent ARMS |
|---|---|
| JDK 17 (sans Spring Boot 3.0) | V2.8.3 |
| JDK 17 avec Spring Boot 3.0 | V2.9.1.2 |
L'agent ARMS V2.8.3 prend en charge JDK 17, mais pas Spring Boot 3.0. Spring Boot 3.0 nécessite JDK 17. Si votre application utilise Spring Boot 3.0, mettez à niveau l'agent ARMS vers la version V2.9.1.2 ou une version ultérieure.
Solution
Mettez à niveau l'agent ARMS vers la version correspondant à votre framework d'application. Pour connaître la procédure de mise à niveau, consultez la documentation relative à la mise à niveau de l'agent ARMS.
Vérification de la correction
Redémarrez votre application après la mise à niveau.
Vérifiez les journaux de démarrage de l'agent ARMS afin de vous assurer que la bonne version de l'agent est chargée. Recherchez une entrée de journal contenant le numéro de version de l'agent.
Ouvrez la console ARMS et accédez à la page de supervision de votre application.
Confirmez que les données de supervision apparaissent au bout de quelques minutes.
Cause 2 : Une dépendance obsolète de l'API Servlet entraîne une instrumentation incorrecte
À partir de Spring Boot 3.0, le serveur Apache Tomcat intégré a été mis à niveau vers Tomcat 10, qui utilise Servlet 5.0. Cette version a modifié le nom du package de l'API Servlet, passant de javax à jakarta.
L'agent ARMS utilise le nom du package de l'API Servlet pour déterminer où appliquer l'instrumentation. Si les dépendances POM de votre application incluent une ancienne version de l'API Servlet (utilisant le nom de package javax) que l'application n'utilise pas réellement, l'agent détecte le mauvais nom de package et applique l'instrumentation à javax au lieu de jakarta. L'instrumentation ne prend pas effet et la console n'affiche aucune donnée de supervision.
Méthode de vérification
Examinez le fichier pom.xml de votre projet pour y déceler les dépendances de l'API Servlet utilisant l'espace de noms javax :
<!-- Example: stale dependency that causes the issue -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
</dependency>Si votre application Spring Boot 3.0 inclut une telle dépendance sans l'utiliser, l'agent ARMS risque d'identifier incorrectement la cible de l'instrumentation.
Solution
Choisissez l'une des approches suivantes :
Supprimez la dépendance inutilisée de l'API Servlet. Supprimez la dépendance
javax.servletde votre fichierpom.xmlsi votre application n'en a pas besoin. Cela permet à l'agent ARMS de détecter le nom de packagejakartacorrect.Mettez à niveau l'agent ARMS vers la version V3.2.0 ou ultérieure. L'agent ARMS V3.2.0 corrige ce problème en identifiant correctement le nom de package actif de l'API Servlet, indépendamment des dépendances obsolètes présentes dans le fichier POM. Pour mettre à niveau vers la version V3.2.0, soumettez un ticket.
Vérification de la correction
Redémarrez votre application après avoir supprimé la dépendance inutilisée ou mis à niveau l'agent ARMS.
Vérifiez les journaux de démarrage de l'agent ARMS pour confirmer son chargement réussi.
Ouvrez la console ARMS et accédez à la page de supervision de votre application.
Confirmez que les données de supervision, telles que les traces et les métriques, apparaissent au bout de quelques minutes.
Référence rapide
| Symptôme | Cause probable | Correction |
|---|---|---|
| Aucune donnée, agent ARMS antérieur à la version V2.8.3 | L'agent ne prend pas en charge JDK 17 | Mettez à niveau vers la version V2.8.3 ou ultérieure |
| Aucune donnée, application Spring Boot 3.0, agent ARMS antérieur à la version V2.9.1.2 | L'agent ne prend pas en charge Spring Boot 3.0 | Mettez à niveau vers la version V2.9.1.2 ou ultérieure |
Aucune donnée, application Spring Boot 3.0, dépendance javax.servlet obsolète dans le fichier POM |
L'agent applique l'instrumentation au mauvais nom de package | Supprimez la dépendance obsolète ou mettez à niveau vers la version V3.2.0 ou ultérieure |