跳到主要内容

应用服务器配置

在使用 Java Agent 对运行在 Java 应用服务器上的应用程序进行检测时，您必须在 JVM 参数中添加 javaagent 路径。

不同的服务器配置方式也不同。

JBoss EAP / WildFly​

您可以在独立配置文件末尾添加 javaagent 参数：

# 添加到 standalone.conf
JAVA_OPTS="$JAVA_OPTS -javaagent:/path/to/opentelemetry-javaagent.jar"

Jetty​

要定义 Java Agent 的路径，请使用 -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 Agent 路径：

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

您也可以通过管理控制台添加 -javaagent 参数：

  1. 在 http://localhost:4848 打开 GlassFish 管理控制台
  2. 转到 配置 > server-config > JVM 设置
  3. 选择 JVM 选项 > 添加 JVM 选项
  4. 输入 Agent 路径：-javaagent:/path/to/opentelemetry-javaagent.jar
  5. 保存 并重启服务器

请确保域目录中的 domain.xml 文件包含 Agent 的 <jvm-options> 条目。

Tomcat / TomEE​

在启动脚本中添加 Java Agent 路径：

# 添加到 <tomcat_home>/bin/setenv.sh
CATALINA_OPTS="$CATALINA_OPTS -javaagent:/path/to/opentelemetry-javaagent.jar"

WebLogic​

在域启动脚本中添加 Java Agent 路径：

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

对于受管服务器实例，请使用管理控制台添加 -javaagent 参数。

WebSphere Liberty Profile​

在 jvm.options 文件中添加 Java Agent 路径。对于单个服务器，编辑 ${server.config.dir}/jvm.options；

对于所有服务器，编辑 ${wlp.install.dir}/etc/jvm.options：

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

保存文件后重启服务器。

WebSphere Traditional​

打开 WebSphere 管理控制台，按照以下步骤操作：

  1. 导航到 服务器 > 服务器类型 > WebSphere 应用服务器
  2. 选择服务器
  3. 转到 Java 和进程管理 > 进程定义
  4. 选择 Java 虚拟机
  5. 在 通用 JVM 参数 中，输入 Agent 路径：-javaagent:/path/to/opentelemetry-javaagent.jar
  6. 保存配置并重启服务器
提示

确保所有路径使用正确的目录分隔符，在 Windows 上使用反斜杠 \，在 Linux/Unix 上使用正斜杠 /。