Configuration du serveur d'application

Lors de l’instrumentation d’une application qui s’exécute sur un serveur d’applications Java avec un agent Java, vous devez ajouter le chemin javaagent aux arguments de la JVM. La manière de le faire diffère d’un serveur à l’autre.

JBoss EAP / WildFly

Vous pouvez ajouter l’argument javaagent à la fin du fichier de configuration :

• Linux
• Windows

# Ajouter à standalone.conf {#add-to-standaloneconf}
JAVA_OPTS="$JAVA_OPTS -javaagent:/path/to/opentelemetry-javaagent.jar"

rem Ajouter à standalone.conf.bat
set "JAVA_OPTS=%JAVA_OPTS% -javaagent:<Drive>:\path\to\opentelemetry-javaagent.jar"

Jetty

Pour définir le chemin vers l’agent Java, utilisez l’argument -javaagent :

java -javaagent:/path/to/opentelemetry-javaagent.jar -jar start.jar

Si vous utilisez le fichier jetty.sh pour démarrer Jetty, ajoutez la ligne suivante au fichier \<jetty_home\>/bin/jetty.sh :

JAVA_OPTIONS="${JAVA_OPTIONS} -javaagent:/path/to/opentelemetry-javaagent.jar"

Si vous utilisez le fichier start.ini pour définir les arguments de la JVM, ajoutez l’argument javaagent après l’option --exec :

#===========================================================
# Exemple de fichier start.ini pour Jetty {#sample-jetty-startini-file}
#-----------------------------------------------------------
--exec
-javaagent:/path/to/opentelemetry-javaagent.jar

Glassfish / Payara

Ajoutez le chemin vers l’agent Java en utilisant l’outil asadmin :

• Linux
• Windows

<server_install_dir>/bin/asadmin create-jvm-options "-javaagent\:/path/to/opentelemetry-javaagent.jar"

<server_install_dir>\bin\asadmin.bat create-jvm-options '-javaagent\:<Drive>\:\\path\\to\\opentelemetry-javaagent.jar'

Vous pouvez également ajouter l’argument -javaagent depuis la console d’administration. Par exemple :

1. Ouvrez la console d’administration de GlassFish sur http://localhost:4848.
2. Allez à Configurations > server-config > JVM Settings.
3. Sélectionnez JVM Options > Add JVM Option.
4. Entrez le chemin vers l’agent : -javaagent:/path/to/opentelemetry-javaagent.jar
5. Enregistrez et redémarrez le serveur.

Assurez-vous que le fichier domain.xml dans votre répertoire de domaine contient une entrée <jmv-options> pour l’agent.

Tomcat / TomEE

Ajoutez le chemin vers l’agent Java à votre script de démarrage :

• Linux
• Windows

# Ajouter à <tomcat_home>/bin/setenv.sh {#add-to-tomcat_homebinsetenvsh}
CATALINA_OPTS="$CATALINA_OPTS -javaagent:/path/to/opentelemetry-javaagent.jar"

rem Ajouter à <tomcat_home>\bin\setenv.bat
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:"<Drive>:\path\to\opentelemetry-javaagent.jar"

WebLogic

Ajoutez le chemin vers l’agent Java à votre script de démarrage de domaine :

• Linux
• Windows

# Ajouter à <domain_home>/bin/startWebLogic.sh {#add-to-domain_homebinstartweblogicsh}
export JAVA_OPTIONS="$JAVA_OPTIONS -javaagent:/path/to/opentelemetry-javaagent.jar"

rem Ajouter à <domain_home>\bin\startWebLogic.cmd
set JAVA_OPTIONS=%JAVA_OPTIONS% -javaagent:"<Drive>:\path\to\opentelemetry-javaagent.jar"

Pour les instances de serveur géré, ajoutez l’argument -javaagent en utilisant la console d’administration.

WebSphere Liberty Profile

Ajoutez le chemin vers l’agent Java au fichier jvm.options. Pour un seul serveur, éditez ${server.config.dir}/jvm.options, et pour tous les serveurs, éditez ${wlp.install.dir}/etc/jvm.options :

-javaagent:/path/to/opentelemetry-javaagent.jar

Redémarrez le serveur après avoir enregistré le fichier.

WebSphere Traditional

Ouvrez la console d’administration de WebSphere et suivez ces étapes :

1. Naviguez vers Servers > Server type > WebSphere application servers.
2. Sélectionnez le serveur.
3. Allez à Java and Process Management > Process Definition.
4. Sélectionnez Java Virtual Machine.
5. Dans Generic JVM arguments, entrez le chemin vers l’agent : -javaagent:/path/to/opentelemetry-javaagent.jar.
6. Enregistrez la configuration et redémarrez le serveur.