Spécifier les arguments du mandataire

Vous pouvez spécifier des arguments mandataires dans la commande java lors du provisionnement de l'agent Java APM, ou vous pouvez le faire plus tard en spécifiant des valeurs pour les arguments dans le fichier AgentConfig.properties du répertoire <Destination Directory>/oracle-apm-agent/config et en redémarrant le serveur d'applications.

Notez que <Destination Directory> dans la phrase précédente désigne le répertoire dans lequel l'agent Java APM est provisionné.

Spécifier un environnement mandataire

Si vous utilisez un serveur mandataire, vous devez fournir les détails de l'environnement du mandataire.

  • 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 :

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

  • Si vous utilisez la passerelle de gestion :
    Configurez l'agent Java APM avec les arguments suivants pour acheminer tout le trafic de l'agent Java ou du traceur APM au moyen de la passerelle de gestion :
    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 la passerelle de gestion, voir Passerelle de gestion.

Si le serveur mandataire a besoin d'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 mandataire 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 digeste.

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