Indiquer des arguments proxy

Vous pouvez indiquer des arguments proxy dans la commande java lors du provisionnement de l'agent Java APM. Vous pouvez également le faire ultérieurement en indiquant des valeurs pour les arguments dans le fichier AgentConfig.properties du répertoire <Destination Directory>/oracle-apm-agent/config, puis en redémarrant le serveur d'applications.

Dans la phrase précédente, <Destination Directory> correspond au répertoire dans lequel l'agent Java APM est provisionné.

Spécification d'un environnement proxy

Si vous utilisez un serveur proxy, vous devez indiquer les détails de l'environnement proxy.

  • Si vous provisionnez l'agent Java APM :

    Ajoutez -property=com.oracle.apm.agent.data.upload.proxy.url=http://<host>:<port> à la commande java. Voici un exemple :

    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
  • Si vous avez déjà provisionné l'agent Java APM :

    Indiquez une valeur pour l'argument com.oracle.apm.agent.data.upload.proxy.url dans le fichier AgentConfig.properties et redémarrez le serveur d'applications.

  • Si vous utilisez Management Gateway :
    Configurez l'agent Java APM avec les arguments suivants pour acheminer tout le trafic de l'agent Java ou du traceur APM via Management Gateway :
    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

    La passerelle de gestion peut être utilisée pour communiquer avec l'agent APM. Pour plus d'informations sur l'installation et la configuration de Management Gateway, reportez-vous à Management Gateway.

Si le serveur proxy nécessite une authentification, vous devez spécifier les arguments d'authentification au format -property=<key>=<value> lors du provisionnement de l'agent Java APM ou mettre à jour le fichier AgentConfig.properties si vous avez déjà provisionné l'agent :

  • Indiquez le nom d'utilisateur et le mot de passe du proxy dans les arguments suivants :
    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>
  • Le modèle d'authentification par défaut est digest.

    Un argument supplémentaire peut être défini pour le modèle d'authentification basic :
    com.oracle.apm.agent.data.upload.proxy.scheme=basic