Java Agent 手动安装方法

OneAPM 提供 Java Agent 自动安装方法,和 Tomcat, Jetty, JBoss 以及 Glassfish 完全兼容。其他平台仍需要手动编辑启动脚本。

下载文件

使用 Java Agent, 您需要一个 OneAPM 账户。该 Agent 需要 Java 1.5 或以上。

.zip 文件需要两种文件以完成安装:

  • oneapm.jar:包含 Agent class 文件。
  • oneapm.properites:包含 OneAPM Agent 的配置信息,包括您的授权编号、应用名称、SSL 设置等。

在服务器启动中,Agent 会在含有 oneapm.jar 的目录下搜索 oneapm.properites 文件。oneapm 会在同一位置下的下属目录编写 Agent 日志,命名为 logs。

如果您已经有了账户但还未安装 oneapm, 开始使用 OneAPM 应用性能监控页面会自动出现。

安装 Java Agent

  • 在应用程序服务器的根目录下,创建名为 oneapm 的文件夹
  • 解压下载的文件到 oneapm 目录中。
  • 在安装开始前,备份 oneapm.properites 配置文件。
  • 使用 -javaagent:/path/to/oneapm.jar,启动或重启应用程序服务器,将参数传递到 Java 虚拟机。
  • 登录 oneapm 账号,查看应用程序性能。

特定平台安装注释

平台 安装注释
TongWeb

修改 startserver.sh和startservernohup.sh,添加内容如下:

export JAVA_OPTIONS="${JAVA_OPTIONS}
  -javaagent:/full/path/to/oneapm.jar"
(-javaagent 选项要指向 oneapm 的安装全路径)
 Geronimo

 对于 Apache Geronimo, 运行启动指令,JAVA_OPTS 环境变量下的 OneAPM agent jar:

export JAVA_OPTS="$JAVA_OPTS 
  -javaagent:/full/path/to/oneapm.jar" && geronimo run
 Glassfish  查看 Glassfish 安装
 JBoss  查看 JBoss 安装
 Jetty

 Jetty 6及以下版本 启动脚本 (jetty.sh)可以使用 JAVA_OPTIONS 环境变量配置:

export JAVA_OPTIONS="${JAVA_OPTIONS}
  -javaagent:/full/path/to/oneapm.jar"

(-javaagent 选项要指向 oneapm 的安装全路径)

其他版本查看 Jetty 安装方法

 Resin

查看 Resin 安装

 Solr

 对于一个 stand alone 的 Solr, 在 start.jar 之前加入 -javaagent:

java -javaagent:/full/path/to/oneapm.jar -jar start.jar
在应用服务器环境下运行 Solr, 遵循该应用服务器的说明加入 javaagent flag. 同时保证应用服务器已经启用 JMX。
 Tomcat

 查看 Tomcat 安装

修改 catalina.sh,添加内容如下:

export JAVA_OPTS="$JAVA_OPTS
  -javaagent:/full/path/to/oneapm.jar"


(-javaagent 选项要指向 oneapm 的安装全路径)

 WebLogic

 查看 WebLogic安装

修改 startWebLogic.sh 或 startWebLogic.bat,添加内容如下:

export JAVA_OPTS="$JAVA_OPTS
  -javaagent:/full/path/to/oneapm.jar"


(-javaagent 选项要指向 oneapm 的安装全路径)

 WebSphere

 查看 WebSphere 安装

对于 WebSphere 通用版, 在运行启动命令时参考在 JAVA_OPTS 环境变量下的 OneAPM agent jar:

export JAVA_OPTS="$JAVA_OPTS
  -javaagent:/full/path/to/oneapm.jar" && startup
 其他应用服务器

 OneAPM Java Agent 可以工作在任何应用程序服务器上通过

-javaagent:/path/to/oneapm.jar

切换到 java 虚拟机

 

 

还有其他问题? 提交请求

您还可以采取以下方式解决问题: