安装应用性能代理

应用性能依赖基于仪表技术的代理来收集和传送数据。

Web组件支持：JSP、Servlets、EJB

Web Frameworks支持： Struts

ORM Frameworks支持： Hibernate、Spring、iBATIS

本节涵盖了以下安装应用性能Java代理的内容：

• 在Apache Tomcat中部署应用性能Java代理
  • 在Windows平台的服务内安装
  • 在Windows平台中使用catalina.bat启动服务器
  • 在Linux平台中使用catalina.sh启动服务器
• 在WebSphere中部署应用性能Java代理
• 在JBoss中部署应用性能Java代理
• 在WebLogic中部署应用性能Java代理
• 在其他服务器中配置应用性能Java代理

在Apache Tomcat中安装应用性能Java代理

应用性能代理可以使用以下方法安装在Apache Tomcat服务器中：

在Windows平台的服务内安装

你可以在安装为Windows服务的Apache Tomcat中部署应用性能。

• 下载apminsight-javaagent.zip

• 解压文件，找到apminsight-javaagent.jar以及它的配置文件apminsight.conf

• 将两个文件移动到tomcat主目录下的一个新建目录，如apminsight

• tomcat主目录即安装Apache Tomcat服务器的目录

  例如： c:/softwares/apache-tomcat/apminsight

• 跳至Configure Tomcat --> JAVA标签，在Java Option中添加Java代理的条目 -javaagent:D:\apminsight\apminsight-javaagent.jar，如下图所示

• 可以在系统托盘图标中找到Apache Tomcat的图标，右键单击并选择Configure选项打开Tomcat属性窗口

• 在添加完Java代理的进入条目后，点击应用并确定

• 跳至 <tomcat_home>/apminsight 目录找到apminsight.conf

• 使用文本编辑器打开文件，设置键application.name ，为应用设置一个合适的名称，如：application.name=JpetStore

• 在apminsight.conf 中设置apm.host和apm.port，使应用性能Java代理可以和Applications Manager通信，它们的值代表Applications Manager的主机地址和端口。 例如：apm.host=myapmmachine .mydomain.com，apm.port=9090

更多应用性能Java代理的配置选项，请参阅这里

在Windows平台中使用catalina.bat启动服务器

是Windows平台中，你可以使用catalina.bat批处理文件安装应用性能

• 下载apminsight-javaagent.zip

• 解压文件，找到apminsight-javaagent.jar以及它的配置文件apminsight.conf

• 将两个文件移动到tomcat_home目录下的一个新建目录，如apminsight

• tomcat_home即安装Apache Tomcat服务器的目录

  例如： c:/softwares/apache-tomcat/apminsight

• 使用文本编辑器打开<tomcat_home>/bin目录下的catalina.bat文件

• 在文件顶部添加以下条目：- SET JAVA_OPTS=%JAVA_OPTS% -javaagent:<path-to- apminsight>/apminsight-javaagent.jar   如： SET JAVA_OPTS=%JAVA_OPTS% -javaagent:c:/softwares/apache- tomcat/apminsight/apminsight-javaagent.jar

• 跳至<tomcat_home>/apminsight目录找到apminsight.conf

• 使用文本编辑器打开文件，设置键application.name ，为应用设置一个合适的名称

  如：application.name=JpetStore

• 在apminsight.conf 中设置apm.host和apm.port，使应用性能Java代理可以和Applications Manager通信，它们的值代表Applications Manager的主机地址和端口

  例如：apm.host=myapmmachine .mydomain.com，apm.port=9090

更多应用性能Java代理的配置选项，请参阅这里

在Linux平台中使用catalina.sh启动服务器

You can also install APM Insight using catalina.bat shell script file to start the server in Linux Platform.

• 下载apminsight-javaagent.zip

• 解压文件，找到apminsight-javaagent.jar以及它的配置文件apminsight.conf

• 将两个文件移动到tomcat_home目录下的一个新建目录，如apminsight

• tomcat_home即安装Apache Tomcat服务器的目录

  如： /home/local/softwares/apache-tomcat/apminsight

• 使用文本编辑器打开<tomcat_home>/bin文件夹下的catalina.sh

• 在文件顶部添加以下条目

  SET JAVA_OPTS=%JAVA_OPTS% -javaagent:<path-to- apminsight>/apminsight-javaagent.jar
  如：SET JAVA_OPTS=%JAVA_OPTS% -javaagent:/home/local/softwares/apache-tomcat/apminsight/apminsight- javaagent.jar

• 跳至 <tomcat_home>/apminsight 目录找到apminsight.conf

• 使用文本编辑器打开文件，设置键application.name ，为应用设置一个合适的名称

  如：application.name=JpetStore

• 在apminsight.conf 中设置apm.host和apm.port，使应用性能Java代理可以和Applications Manager通信，它们的值代表Applications Manager的主机地址和端口

  例如：apm.host=myapmmachine .mydomain.com，apm.port=9090

更多应用性能Java代理的配置选项，请参阅这里

在WebSphere中部署应用性能Java代理

APM Insight Java Agent can be deployed in Websphere through Admin Console as follows:

• 下载apminsight-javaagent.zip

• 或者，你也可以在<applications_manager_home_directory>/working/resources目录下找到apminsight.zip

• 解压文件，找到apminsight-javaagent.jar以及它的配置文件apminsight.conf

• 将两个文件移动到websphere_home目录下的一个新建目录，如apminsight

• websphere_home 即安装WebSphere应用服务器的目录

  如： c:/softwares/IBM/WebSphere/AppServer/apminsight

• 使用管理员登录控制台

• 打开服务器树目录，点击应用服务器

• 选择你要安装Java代理的服务器

• 在服务器基础结构中，打开Java和进程管理，点击进程定义

• 在其他属性下，点击Java虚拟机

• 在通用JVM参数文本框添加以下内容

  -javaagent:<path-to-websphere_home>/apminsight-javaagent.jar
  例如： -javaagent:c:/softwares/IBM/WebSphere/AppServer/apminsight/apminsight-javaagent.jar
  注意：代理的路径实际上是应用服务器的机器路径

• 如果在文本框中有多个声明，请使用空格将它们分隔开

• 点击应用并保存

• 跳至<websphere_home>/apminsight 目录找到 apminsight.conf

• 使用文本编辑器打开文件，设置键application.name ，为应用设置一个合适的名称

  如：application.name=JpetStore

• 在apminsight.conf 中设置apm.host和apm.port，使应用性能Java代理可以和Applications Manager通信，它们的值代表Applications Manager的主机地址和端口

  例如：apm.host=myapmmachine .mydomain.com，apm.port=9090

更多应用性能Java代理的配置选项，请参阅这里

在JBoss中部署应用性能Java代理

• 下载apminsight-javaagent.zip

• 解压文件，找到apminsight-javaagent.jar以及它的配置文件apminsight.conf

• 将两个文件移动到jboss_home目录下的一个新建目录，如apminsight

• jboss_home即安装JBoss应用服务器的目录

  如： c:/softwares/jboss/apminsight

• 使用文本编辑器打开<jboss_home>/bin 目录下的run.bat

• 在文件顶部添加以下条目：

  SET JAVA_OPTS=%JAVA_OPTS% -javaagent:<path-to-jboss_home>/apminsight-javaagent.jar

• 跳至<jboss_home>/apminsight 目录找到 apminsight.conf

• 使用文本编辑器打开文件，设置键application.name ，为应用设置一个合适的名称

  如：application.name=JpetStore

• 在apminsight.conf 中设置apm.host和apm.port，使应用性能Java代理可以和Applications Manager通信，它们的值代表Applications Manager的主机地址和端口

  例如：apm.host=myapmmachine .mydomain.com，apm.port=9090

更多应用性能Java代理的配置选项，请参阅这里

在WebLogic中部署应用性能Java代理

• 下载apminsight-javaagent.zip

• 解压文件，找到apminsight-javaagent.jar以及它的配置文件apminsight.conf

• 将两个文件移动到weblogic_home目录下的一个新建目录，如apminsight

  如：c:/softwares/bea/weblogic/server/apminsight

• 使用文本编辑器打开<weblogic-home>/bin目录下的startWLS.bat

• 在文件顶部添加以下条目：

  SET JAVA_OPTIONS=%JAVA_OPTIONS% -javaagent:<path-to-weblogic_home>/apminsight/apminsight-javaagent.jar

• 跳至<weblogic_home>/apminsight  目录找到apminsight.conf

• 使用文本编辑器打开文件，设置键application.name ，为应用设置一个合适的名称

  如：application.name=JpetStore

• 在apminsight.conf 中设置apm.host和apm.port，使应用性能Java代理可以和Applications Manager通信，它们的值代表Applications Manager的主机地址和端口

  例如：apm.host=myapmmachine .mydomain.com，apm.port=9090

更多应用性能Java代理的配置选项，请参阅这里

在其他服务器中配置应用性能Java代理

• 下载apminsight-javaagent.zip

• 解压文件，找到apminsight-javaagent.jar以及它的配置文件apminsight.conf

• 将两个文件移动到Application_Server_home目录下的一个新建目录，如apminsight

• Application_Server_Home即安装的应用服务器的目录

• 找到你的应用服务器的启动脚本，使用文本编辑器打开它

• 在文件顶部添加以下条目：

SET JAVA_OPTS=%JAVA_OPTS% -javaagent:<path-to-application_server_home>/apminsight/apminsight-javaagent.jar

• 跳至<application_server_home>/apminsight 目录找到 apminsight.conf

• 使用文本编辑器打开文件，设置键application.name ，为应用设置一个合适的名称

  如：application.name=JpetStore

• 在apminsight.conf 中设置apm.host和apm.port，使应用性能Java代理可以和Applications Manager通信，它们的值代表Applications Manager的主机地址和端口

  例如：apm.host=myapmmachine .mydomain.com，apm.port=9090

更多应用性能Java代理的配置选项，请参阅这里