Application Real-Time Monitoring Service:Troubleshoot ARMS agent manual installation failures

ps -ef | grep java | grep javaagent

Symptôme

L'erreur LicenseKey is invalid apparaît dans les journaux situés dans le répertoire ArmsAgent/log/.

Cause

Le package d'installation de l'agent ARMS est spécifique à une région. Les informations sur l'endpoint ARMS sont encapsulées dans le package. Si vous téléchargez le package pour une région différente de celle où s'exécute votre application, l'agent ne peut pas se connecter au bon endpoint ARMS.

Solution

1. Vérifiez la région dans laquelle s'exécute votre application.

2. Téléchargez le package d'installation de l'agent ARMS correspondant à cette région. Pour obtenir les liens de téléchargement, consultez la page Installation manuelle d'un agent ARMS.

3. Remplacez le répertoire de l'agent existant par le package que vous venez de télécharger.

4. Redémarrez votre application.

Symptôme

L'erreur LicenseKey is invalid apparaît dans les journaux de l'agent situés dans le répertoire ArmsAgent/log/.

Cause

La clé de licence spécifiée dans la commande de démarrage ne correspond pas à la clé de licence attribuée à votre application dans la console ARMS.

Solution

1. Connectez-vous à la console ARMS.

2. Dans le volet de navigation de gauche, choisissez Application Monitoring > Application List.

3. Sur la page Applications, cliquez sur le nom de votre application et repérez la clé de licence.

4. Comparez la clé de licence affichée dans la console avec la valeur du paramètre -Darms.licenseKey dans votre commande de démarrage. Assurez-vous qu'elles sont identiques.

5. Si les valeurs diffèrent, mettez à jour la commande de démarrage avec la clé de licence correcte et redémarrez votre application.

Symptôme

L'agent ARMS ne démarre pas ou ne signale aucune donnée après le démarrage de l'application.

Cause

Certaines premières versions de JDK 1.8, notamment 1.8.0_25 et 1.8.0_31, présentent des problèmes de compatibilité connus qui empêchent l'agent ARMS de fonctionner correctement.

Solution

1. Vérifiez votre version JDK :

   java -version

2. Si la sortie indique la version 1.8.0_25 ou 1.8.0_31, mettez à niveau vers une version JDK ultérieure.

3. Pour obtenir la liste complète des versions JDK et des frameworks pris en charge, consultez la section Composants et frameworks Java pris en charge par ARMS.

Symptôme

Après le démarrage de l'application, le sous-répertoire logs n'existe pas dans le répertoire ArmsAgent.

Cause

La JVM n'a pas chargé le fichier aliyun-java-agent.jar. Cela se produit généralement lorsque le répertoire ArmsAgent dispose d'autorisations de fichier incorrectes, ou lorsque le paramètre -javaagent dans la commande de démarrage pointe vers un chemin incorrect.

Solution

1. Vérifiez que le paramètre -javaagent dans votre commande de démarrage pointe vers le fichier JAR correct :

   # Example: check the actual process command line
   ps -ef | grep java | grep javaagent

2. Vérifiez que le répertoire ArmsAgent et son contenu sont lisibles par l'utilisateur qui exécute l'application :

   ls -la /path/to/ArmsAgent/

3. Si les autorisations sont incorrectes, corrigez-les :

   chmod -R 755 /path/to/ArmsAgent/

4. Redémarrez l'application et vérifiez si le sous-répertoire logs est créé dans le répertoire ArmsAgent.