APM Java Agentデプロイメントのトラブルシューティング

APM Javaエージェントのデプロイメント中に、ユーザーが異なるエラーが発生することがあります。このセクションには、一般的な原因とアクションがいくつかリストされています。

AgentConnectを使用してネットワーク接続を確認してください

原因: OCI APMアップロード・エンドポイントに接続できません。

アクション: AgentConnectを使用して、ネットワーク接続のトラブルシューティングを行います。

AgentConnect

AgentConnectは、APMエージェントを実行しているホストとOCI APMアップロード・エンドポイント間の接続をテストするために使用するユーティリティです。SSL証明書の問題、FIPSの問題、PKIの問題、プロキシの問題など、さまざまな問題を診断できます。

AgentConnectは、ping、curl、wgetなどの一部のネットワークツールが使用できない場合や、環境の一部でない場合に役立ちます。たとえば、一部のDockerまたはKubernetes環境では、pingユーティリティが使用できません。

要件: PATH内またはJAVA_HOME環境変数で定義されているJDK。
場所: APMエージェントのデプロイメント後、AgentConnectはoracle-APM-agent/binディレクトリにあります。
AgentConnectを実行します: AgentConnectを起動するには、次を使用します:
- Windowsの場合: AgentConnect.bat
- Linuxの場合: AgentConnect.sh
例:
```
C:\apm\oracle-apm-agent\bin>AgentConnect.bat
```
前述の例のように、パラメータなしでAgentConnectを起動すると、AgentConfig.propertiesファイルを使用してすべての構成詳細が読み取られます。

AgentConfig.propertiesファイルのプロパティをオーバーライドする場合は、コマンドラインからそれを実行できます。
AgentConnect help:コマンドラインから使用可能なすべてのヘルプ・オプションを表示するには、 -h 引数を使用してAgentConnectを起動し、コマンド・ヘルプを表示します。例:
```
C:\apm\oracle-apm-agent\bin> AgentConnect -h
```

AgentConnect出力例:

AgentConnect結果: 合格

ネットワーク接続の問題がない場合の例を次に示します。

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

次のような出力が表示されます。

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

前述の出力の最後に、APM Javaエージェントが実行されているホストとOCI APMアップロード・エンドポイントとの間に接続の問題がないことを示すAgentConnect Result: PASSEDというメッセージが表示されます。問題が発生した場合は、Oracle Supportにお問い合わせください。

AgentConnect結果: 失敗

ネットワーク接続の問題がある場合の例を次に示します。この例では、AgentConnectの起動時に、OCI APMアップロード・エンドポイント値https://endpoint.APM-agt.us-phoenix-1.oci.oc-test.com/が引数として渡されます:

C:\apm\oracle-apm-agent\bin> AgentConnect https://endpoint.apm-agt.us-phoenix-1.oci.oc-test.com/

次のような出力が表示されます。

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

前述の出力の最後に、ネットワーク接続の問題があることを示すAgentConnect Result: FAILEDというメッセージが表示されます。出力には、完全なHTTPヘッダーと本文、およびサーバーによって送信された証明書の情報が含まれます。Oracle Supportに連絡してください。

Open Services Gatewayイニシアチブ依存性

監視するアプリケーションがOpen Services Gatewayイニシアチブ(OSGi)に依存する場合は、次のシステム・プロパティを設定してください。

-Dorg.osgi.framework.bootdelegation=com.oracle.apm.*

アプリケーションによっては、ブート委任に別のプロパティーを使用することも、デフォルトでブート委任プロパティーをすでに指定していることもあります。このような場合は、アプリケーション固有のドキュメントに従って、com.oracle.apm.*がブート委任リストに追加されていることを確認します。

Oracle Cloud Infrastructureドキュメント

APM Java Agentデプロイメントのトラブルシューティング