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'environnementJAVA_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. - Pour Windows :
-
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
-
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
-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.