Documentazione di Oracle Cloud Infrastructure

Risolvere i problemi relativi alla distribuzione dell'agente Java APM

Gli utenti possono riscontrare errori diversi durante la distribuzione dell'agente Java APM. In questa sezione sono elencate alcune cause e azioni comuni.

Controllare la connettività di rete utilizzando AgentConnect

Causa: impossibile connettersi all'endpoint di caricamento APM OCI.

Azione: utilizzare AgentConnect per risolvere i problemi di connettività di rete.

AgentConnect

AgentConnect è una utility utilizzata per eseguire il test della connettività tra l'host che esegue l'agente APM e l'endpoint di caricamento APM OCI. Può diagnosticare diversi problemi come, problemi di certificato SSL, problemi FIPS, problemi PKI, problemi proxy e molti altri.

AgentConnect è utile quando alcuni strumenti di rete, ad esempio ping, curl o wget, non sono disponibili e/o non fanno parte dell'ambiente. Ad esempio, alcuni ambienti Docker o Kubernetes non dispongono della utility ping disponibile.

  • Requisito: JDK disponibile in PATH o definito dalla variabile di ambiente JAVA_HOME.

  • Posizione: dopo la distribuzione dell'agente APM, è possibile trovare AgentConnect nella directory oracle-apm-agent/bin.

  • Esegui AgentConnect: per richiamare AgentConnect, utilizzare quanto segue:
    • Per Windows: AgentConnect.bat
    • Per Linux: AgentConnect.sh

    Ad esempio: 

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

    Quando si richiama AgentConnect senza parametri, come nell'esempio precedente, viene utilizzato il file AgentConfig.properties per leggere tutti i dettagli di configurazione.

    Se si desidera eseguire l'override di una delle proprietà nel file AgentConfig.properties, è possibile eseguire l'operazione dalla riga di comando.

  • AgentConnect help: Per visualizzare tutte le opzioni della Guida disponibili dalla riga di comando, richiamare AgentConnect usando l'argomento -h per visualizzare la Guida del comando. Ad esempio: 

    C:\apm\oracle-apm-agent\bin> AgentConnect -h
AgentConnect Esempi di output:

  • AgentConnect Risultato: PASSATO

    Di seguito è riportato un esempio in caso di problemi di connettività di rete: 
    C:\apm\oracle-apm-agent\bin>AgentConnect.bat

    L'output è simile a quanto riportato di seguito. 

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

    Alla fine dell'output riportato sopra, viene visualizzato il messaggio AgentConnect Result: PASSED che indica che non si verificano problemi di connettività tra l'host in cui è in esecuzione l'agente Java APM e l'endpoint di caricamento APM OCI. In caso di problemi, contattare il supporto Oracle.

  • AgentConnect Risultato: NON RIUSCITO

    Vedere di seguito un esempio in caso di problemi di connettività di rete. In questo esempio, il valore dell'endpoint di caricamento APM OCI https://endpoint.apm-agt.us-phoenix-1.oci.oc-test.com/ viene passato come argomento quando si richiama AgentConnect:
    C:\apm\oracle-apm-agent\bin> AgentConnect https://endpoint.apm-agt.us-phoenix-1.oci.oc-test.com/

    L'output è simile a quanto riportato di seguito. 

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

    Alla fine dell'output precedente, viene visualizzato il messaggio AgentConnect Result: FAILED che indica che si sono verificati problemi di connettività di rete. L'output include le intestazioni e il corpo HTTP completi, nonché le informazioni nei certificati inviati dal server. Contattare il Supporto Oracle per assistenza.

Dipendenza iniziativa Open Services Gateway

Se l'applicazione che si desidera monitorare dipende dall'iniziativa Open Services Gateway (OSGi), assicurarsi di impostare la proprietà di sistema seguente:
-Dorg.osgi.framework.bootdelegation=com.oracle.apm.*

Alcune applicazioni potrebbero utilizzare una proprietà diversa per la delega del boot o potrebbero aver già specificato la proprietà di delega del boot per impostazione predefinita. In questi casi, seguire la documentazione specifica dell'applicazione per assicurarsi che com.oracle.apm.* venga aggiunto all'elenco di delega del boot.