プロキシ引数の指定

APM Javaエージェントをプロビジョニングするときにjavaコマンドでプロキシ引数を指定できます。または、<Destination Directory>/oracle-apm-agent/configディレクトリのAgentConfig.propertiesファイルで引数の値を指定してアプリケーション・サーバーを再起動することにより、後でこれを実行できます。

前の文の<Destination Directory>は、APM Javaエージェントがプロビジョニングされるディレクトリです。

プロキシ環境の指定

プロキシ・サーバーを使用している場合は、プロキシ環境の詳細を指定する必要があります。

  • APM Javaエージェントをプロビジョニングする場合:

    javaコマンドに-property=com.oracle.apm.agent.data.upload.proxy.url=http://<host>:<port>を追加します。次に例を示します:

    java -jar ./apm-java-agent-installer-<version>.jar provision-agent -service-name=apm_service -destination=$DOMAIN_HOME -private-data-key=IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD -data-upload-endpoint=https://dataUploadEndpoint.com -property=com.oracle.apm.agent.data.upload.proxy.url=http://proxy.example.com:80
  • APM Javaエージェントをすでにプロビジョニングしている場合:

    AgentConfig.propertiesファイルでcom.oracle.apm.agent.data.upload.proxy.url引数の値を指定し、アプリケーション・サーバーを再起動します。

  • 管理ゲートウェイを使用している場合:
    APM Java Agentを次の引数で構成し、APM Java AgentまたはTracerのすべてのトラフィックを管理ゲートウェイ経由でルーティングします。
    com.oracle.apm.agent.data.upload.proxy.url=<Management Gateway URL>
    com.oracle.apm.agent.data.upload.proxy.username=<User name for Proxy Server authentication>
    com.oracle.apm.agent.data.upload.proxy.password=<Password for Proxy Server authentication>
    com.oracle.apm.agent.data.upload.proxy.scheme=basic

    管理ゲートウェイを使用してAPMエージェントと通信できます。管理ゲートウェイのインストールおよび構成の詳細は、管理ゲートウェイを参照してください。

プロキシ・サーバーで認証が必要な場合は、APM Javaエージェントをプロビジョニングするときに-property=<key>=<value>形式で認証引数を指定するか、エージェントをすでにプロビジョニングしている場合はAgentConfig.propertiesファイルを更新する必要があります。

  • 次の引数にプロキシのユーザー名とパスワードを指定します。
    com.oracle.apm.agent.data.upload.proxy.username=<User name for proxy server authentication>
    com.oracle.apm.agent.data.upload.proxy.password=<Password for proxy server authentication>
  • デフォルトの認証スキームは digestです。

    basic認証スキームに追加の引数を設定できます。
    com.oracle.apm.agent.data.upload.proxy.scheme=basic