Documentation Oracle Cloud Infrastructure

Dépannage du déploiement de l'agent Java APM

Les utilisateurs peuvent rencontrer des erreurs différentes lors du déploiement de l'agent Java APM. Cette section répertorie certaines causes et actions courantes.

Vérifiez la connectivité réseau à l'aide de AgentConnect

Cause : impossible de se connecter à l'adresse de téléchargement OCI APM.

Action : utilisez AgentConnect pour dépanner la connectivité réseau.

AgentConnect

AgentConnect est un utilitaire utilisé pour tester la connectivité entre l'hôte exécutant l'agent APM et l'adresse de téléchargement APM OCI. Il peut diagnostiquer différents problèmes tels que les problèmes de certificat SSL, les problèmes FIPS, les problèmes PKI, les problèmes de proxy et bien d'autres.

AgentConnect est utile lorsque certains outils réseau, tels que ping, curl ou wget, ne sont pas disponibles et/ou ne font pas partie de l'environnement. Par exemple, certains environnements Docker ou Kubernetes ne disposent pas de l'utilitaire ping.

  • Condition requise : JDK disponible dans PATH ou défini par la variable d'environnement JAVA_HOME.

  • Emplacement : après le déploiement de l'agent APM, vous pouvez trouver AgentConnect sous le répertoire oracle-apm-agent/bin.

  • Exécuter AgentConnect : pour appeler AgentConnect, utilisez les éléments suivants :
    • Sous Windows : AgentConnect.bat
    • Pour Linux : AgentConnect.sh

    Exemple : 

    C:\apm\oracle-apm-agent\bin>AgentConnect.bat

    Lorsque vous appelez AgentConnect sans paramètre, comme dans l'exemple ci-dessus, il utilise le fichier AgentConfig.properties pour lire tous les détails de configuration.

    Si vous souhaitez remplacer l'une des propriétés du fichier AgentConfig.properties, vous pouvez le faire à partir de la ligne de commande.

  • Aide AgentConnect : pour afficher toutes les options d'aide disponibles à partir de la ligne de commande, appelez AgentConnect en utilisant l'argument -h pour afficher l'aide de la commande. Par exemple : 

    C:\apm\oracle-apm-agent\bin> AgentConnect -h
AgentConnect Exemples de sortie :

  • AgentConnect Résultat : PASSED

    Voir ci-dessous un exemple en l'absence de problème de connectivité réseau : 
    C:\apm\oracle-apm-agent\bin>AgentConnect.bat

    Le résultat se présente comme suit : 

    Using JAVA_HOME: "c:\java\jdk1.8.0_351"

Reading config file 'C:\apm\oracle-apm-agent\config\1.10\AgentConfig.properties'
java version "1.8.0_351" 
Java(TM) SE Runtime Environment (build 1.8.0_351-b10)
Java HotSpot(TM) 64-Bit Server VM (build 25.351-b10, mixed mode)

Testing 'https://aaabbbbcccc.apm-agt.us-phoenix-1.oci.oc-test.com/20200101/opentelemetry/v1/metrics'
    with datakey 'TTTTTEEEEEEMMMMGV4SIPDRJWI'   
    using JDK HttpURLConnection 

HTTP Server Response:
HTTP/1.1 200 OK
Strict-Transport-Security: max-age=31536000; includeSubDomains;
Connection: keep-alive
Content-Length: 0
opc-request-id: /DA962BB6C59E3E845EA503755ABB48C6/EFF6778EDE89E511072E05E2DD15FBFD
Date: Fri, 19 May 2023 14:38:25 GMT

===========================
AgentConnect Result: PASSED
===========================

    A la fin de la sortie ci-dessus, le message AgentConnect Result: PASSED indique qu'il n'existe aucun problème de connectivité entre l'hôte sur lequel l'agent Java APM est exécuté et l'adresse de téléchargement APM OCI. En cas de problème, contactez le support technique Oracle.

  • AgentConnect Résultat : ECHEC

    Voir ci-dessous un exemple de problèmes de connectivité réseau. Dans cet exemple, la valeur d'adresse de téléchargement APM OCI : https://endpoint.apm-agt.us-phoenix-1.oci.oc-test.com/ est transmise en tant qu'argument lors de l'appel de AgentConnect :
    C:\apm\oracle-apm-agent\bin> AgentConnect https://endpoint.apm-agt.us-phoenix-1.oci.oc-test.com/

    Le résultat se présente comme suit : 

    Using JAVA_HOME: "c:\java\jdk1.8.0_351" 
java version "1.8.0_351"
Java(TM) SE Runtime Environment (build 1.8.0_351-b10)
Java HotSpot(TM) 64-Bit Server VM (build 25.351-b10, mixed mode)

Testing 'https://endpoint.apm-agt.us-phoenix-1.oci.oc-test.com/20200101/opentelemetry/v1/metrics'
   using JDK HttpURLConnection

HTTP Server Cert Info:
Cipher Suite: TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
  0) Cert Type: X.509
     Hash Code: 561797842
     Public Key Algorithm: RSA
     Public Key Format: X.509
     X509 Issuer: CN=DigiCert Global G2 TLS RSA SHA256 2020CA1, O=DigiCert Inc, C=US
     X509 Subject:CN=*.apm-agt.us-phoenix-1.oci.oc-test.com, O=Oracle Corporation, L=Redwood City, ST=California,      C=US
     X509 Signature Algorithm Name: SHA256withRSA 
     X509 Signature Algorithm OID: 1.2.840.113549.1.1.11
     X509 Start Date: Sun Jun   0517:00:00PDT 2022
     X509 End Date: Tue Jun 0616:59:59PDT 2023
     X509 PublicKey: Sun RSA publickey, 2048bits
     X509 Version: 3
  1) Cert Type: X.509
     Hash Code: -38378014
     Public Key Algorithm: RSA
     Public Key Format: X.509
     X509 Issuer: CN=DigiCert Global Root G2, OU=www.digicert.com, O=DigiCert Inc,      C=US
     X509 Subject: CN=DigiCert Global G2 TLS RSA SHA256 2020CA1, O=DigiCert Inc, C=US
     X509 Signature Algorithm Name: SHA256withRSA
     X509 Signature Algorithm OID: 1.2.840.113549.1.1.11
     X509 Start Date: Wed Sep 23 17:00:00 PDT 2020
     X509 End Date: Mon Sep 23 16:59:59 PDT 2030
     X509 PublicKey: Sun RSA publickey, 2048 bits
     X509 Version: 3

HTTP Server Response:
HTTP/1.1404 Not Found
Strict-Transport-Security: max-age=31536000; includeSubDomains;
Connection: keep-alive
Content-Length: 146
Date: Fri,19 May 2023 14:59:41 GMT
Content-Type: text/html

<html>
<head><title>404Not Found</title></head>
<body>
<center><h1>404Not Found</h1></center>
<hr><center>nginx</center>
</body>
</html> 

===========================
AgentConnect Result: FAILED
===========================

    A la fin de la sortie ci-dessus, le message AgentConnect Result: FAILED indique qu'il existe des problèmes de connectivité réseau. La sortie inclut le corps et les en-têtes HTTP complets, ainsi que des informations dans les certificats envoyés par le serveur. Pour obtenir de l'aide, contactez le support technique Oracle.

Dépendance d'initiative Open Services Gateway

Si l'application que vous souhaitez surveiller dépend de l'initiative Open Services Gateway (OSGi), veillez à définir la propriété système suivante :
-Dorg.osgi.framework.bootdelegation=com.oracle.apm.*

Certaines applications peuvent utiliser une propriété différente pour la délégation d'initialisation ou avoir déjà spécifié la propriété de délégation d'initialisation par défaut. Dans ce cas, suivez la documentation propre à l'application pour vous assurer que com.oracle.apm.* est ajouté à la liste des délégations d'initialisation.