应用服务器配置

如何为 Java 应用服务器定义代理路径

在使用 Java 代理对运行在 Java 应用服务器上的应用程序进行插桩时,必须将 javaagent 路径添加到 JVM 参数中。 不同服务器的实现方法各不相同。

JBoss EAP、WildFly

你可以在独立配置文件的末尾添加 javaagent 参数:

# 添加到 standalone.conf 中
JAVA_OPTS="$JAVA_OPTS -javaagent:/path/to/opentelemetry-javaagent.jar"
rem 添加到 standalone.conf 中
set "JAVA_OPTS=%JAVA_OPTS% -javaagent:<Drive>:\path\to\opentelemetry-javaagent.jar"

Jetty

要定义 Java 代理的路径,请使用 -javaagent 参数:

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

如果使用 jetty.sh 文件启动 Jetty,请将以下行添加到 \<jetty_home\>/bin/jetty.sh 文件中:

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

如果使用 start.ini 文件来定义 JVM 参数,请在 --exec 选项后添加 javaagent 参数:

#===========================================================
# Jetty 的 start.ini 文件示例
#-----------------------------------------------------------
--exec
-javaagent:/path/to/opentelemetry-javaagent.jar

Glassfish、Payara

使用 asadmin 工具添加 Java 代理的路径:

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

你也可以从管理控制台添加 -javaagent 参数。例如:

  1. http://localhost:4848 打开 GlassFish 管理控制台。
  2. 转到 Configurations > server-config > JVM Settings
  3. 选择 JVM Options > Add JVM Option
  4. 输入代理的路径: -javaagent:/path/to/opentelemetry-javaagent.jar
  5. Save and restart the server.

确保你的域目录下的 domain.xml 文件中包含针对代理的 <jmv-options> 条目。

Tomcat / TomEE

将 Java 代理的路径添加到启动脚本中:

# 添加到 <tomcat_home>/bin/setenv.sh
CATALINA_OPTS="$CATALINA_OPTS -javaagent:/path/to/opentelemetry-javaagent.jar"
rem 添加到 <tomcat_home>\bin\setenv.bat
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:"<Drive>:\path\to\opentelemetry-javaagent.jar"

WebLogic

将 Java 代理的路径添加到域启动脚本中:

# 添加到 <domain_home>/bin/startWebLogic.sh
export JAVA_OPTIONS="$JAVA_OPTIONS -javaagent:/path/to/opentelemetry-javaagent.jar"
rem 添加到 <domain_home>\bin\startWebLogic.cmd
set JAVA_OPTIONS=%JAVA_OPTIONS% -javaagent:"<Drive>:\path\to\opentelemetry-javaagent.jar"

对于受管服务器实例,请通过管理控制台添加 -javaagent 参数。

WebSphere Liberty Profile

将 Java 代理的路径添加到 jvm.options 文件中。 对于单个服务器,编辑 ${server.config.dir}/jvm.options, 对于所有服务器,编辑 ${wlp.install.dir}/etc/jvm.options

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

保存文件后重启服务器。

WebSphere 传统版

打开 WebSphere 管理控制台并执行以下步骤:

  1. 导航到 Servers > Server type > WebSphere application servers
  2. 选择服务器。
  3. 转到 Java and Process Management > Process Definition
  4. 选择 Java Virtual Machine
  5. Generic JVM arguments 中,输入代理的路径: -javaagent:/path/to/opentelemetry-javaagent.jar
  6. 保存配置并重启服务器。