Documentación de Oracle Cloud Infrastructure

Solución de problemas del despliegue del agente Java de APM

Los usuarios pueden encontrar diferentes errores durante el despliegue del agente Java de APM. En esta sección, se enumeran algunas causas y acciones comunes.

Compruebe la conectividad de red mediante AgentConnect

Causa: no se puede conectar al punto final de carga de APM de OCI.

Acción: utilice AgentConnect para solucionar problemas de conectividad de red.

AgentConnect

AgentConnect es una utilidad que se utiliza para probar la conectividad entre el host que ejecuta el agente de APM y el punto final de carga de APM de OCI. Puede diagnosticar diferentes problemas, como problemas de certificados SSL, problemas de FIPS, problemas de PKI, problemas de proxy y muchos más.

AgentConnect es útil cuando algunas herramientas de red, como ping, curl o wget, no están disponibles y/o no forman parte del entorno. Por ejemplo, algunos entornos de Docker o Kubernetes no tienen la utilidad ping disponible.

  • Requisito: JDK disponible en PATH o definido por la variable de entorno JAVA_HOME.

  • Ubicación: después del despliegue del agente de APM, puede encontrar AgentConnect en el directorio oracle-apm-agent/bin.

  • Ejecutar AgentConnect: para llamar a AgentConnect, utilice lo siguiente:
    • Para Windows: AgentConnect.bat
    • Para Linux: AgentConnect.sh

    Por ejemplo: 

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

    Al llamar a AgentConnect sin parámetros, como en el ejemplo anterior, utiliza el archivo AgentConfig.properties para leer todos los detalles de configuración.

    Si desea sustituir cualquiera de las propiedades del archivo AgentConfig.properties, puede hacerlo desde la línea de comandos.

  • ayuda AgentConnect: para mostrar todas las opciones de ayuda disponibles desde la línea de comandos, invoque AgentConnect mediante el argumento -h para mostrar la ayuda del comando. Por ejemplo: 

    C:\apm\oracle-apm-agent\bin> AgentConnect -h
Ejemplos de salida de AgentConnect:

  • AgentConnect Resultado: APROBADO

    A continuación, se muestra un ejemplo cuando no hay problemas de conectividad de red: 
    C:\apm\oracle-apm-agent\bin>AgentConnect.bat

    La salida presenta un aspecto similar al siguiente: 

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

    Al final de la salida anterior, verá el mensaje: AgentConnect Result: PASSED, que indica que no hay problemas de conectividad entre el host en el que se ejecuta el agente Java de APM y el punto final de carga de APM de OCI. Si hay problemas, póngase en contacto con los Servicios de Soporte Oracle.

  • AgentConnect Resultado: FALLIDO

    A continuación, se muestra un ejemplo cuando hay problemas de conectividad de red. En este ejemplo, el valor del punto final de carga de APM de OCI: https://endpoint.apm-agt.us-phoenix-1.oci.oc-test.com/ se transfiere como un argumento al llamar a AgentConnect:
    C:\apm\oracle-apm-agent\bin> AgentConnect https://endpoint.apm-agt.us-phoenix-1.oci.oc-test.com/

    La salida presenta un aspecto similar al siguiente: 

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

    Al final de la salida anterior, verá el mensaje: AgentConnect Result: FAILED, que indica que hay problemas de conectividad de red. La salida incluye el cuerpo y las cabeceras HTTP completas, así como información en los certificados enviados por el servidor. Póngase en contacto con los Servicios de Soporte de Oracle para obtener ayuda.

Dependencia de iniciativa de gateway de servicios abiertos

Si la aplicación que desea supervisar depende de la iniciativa Open Services Gateway (OSGi), asegúrese de definir la siguiente propiedad del sistema:
-Dorg.osgi.framework.bootdelegation=com.oracle.apm.*

Es posible que algunas aplicaciones utilicen una propiedad diferente para la delegación de inicio o que ya hayan especificado la propiedad de delegación de inicio por defecto. En estos casos, siga la documentación específica de la aplicación para asegurarse de que com.oracle.apm.* se agrega a la lista de delegación de inicio.