Dépanner le déploiement de l'agent Java APM

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

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

Cause : Connexion au point d'extrémité de chargement APM OCI impossible.

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 le point d'extrémité de 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 mandataire, etc.

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

  • Exigence : 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 dans le répertoire oracle-apm-agent/bin.

  • Exécutez AgentConnect : Pour appeler AgentConnect, utilisez les éléments suivants :
    • Pour 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 voulez remplacer une des propriétés du fichier AgentConfig.properties, vous pouvez le faire à partir de la ligne de commande.

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

    C:\apm\oracle-apm-agent\bin> AgentConnect -h
Exemples de sortie AgentConnect :
  • Résultat AgentConnect : PASSÉ

    Voir ci-dessous un exemple lorsqu'il n'y a pas de problème de connectivité réseau :
    C:\apm\oracle-apm-agent\bin>AgentConnect.bat

    La sortie est semblable à la suivante :

    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
    ===========================

    À la fin de la sortie ci-dessus, vous voyez le message : AgentConnect Result: PASSED, qui indique qu'il n'y a aucun problème de connectivité entre l'hôte sur lequel l'agent Java APM s'exécute et le point d'extrémité de chargement APM OCI. En cas de problème, communiquez avec Oracle Support.

  • Résultat AgentConnect : ÉCHEC

    Voir ci-dessous un exemple de problème de connectivité réseau. Dans cet exemple, la valeur du point d'extrémité de 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/

    La sortie est semblable à la suivante :

    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
    ===========================

    À la fin de la sortie ci-dessus, vous voyez le message : AgentConnect Result: FAILED, qui indique qu'il y a des problèmes de connectivité réseau. La sortie comprend les en-têtes et le corps HTTP complets, ainsi que des informations dans l'ou les certificats envoyés par le serveur. Communiquez avec Oracle Support pour obtenir de l'aide.

Dépendance d'initiative de passerelle de services ouverte

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 ont peut-être déjà spécifié la propriété de délégation d'initialisation par défaut. Dans ces cas, suivez la documentation propre à l'application pour vous assurer que com.oracle.apm.* est ajouté à la liste de délégation d'initialisation.