安装配置Java插件

安装Java插件

要监控Java应用,您需要安装Java插件。首先请切换至Smart Agent安装目录的bin目录,然后执行./plugin.sh -install Java -P [Port] -appType [Web Container] -appHome [Web Container_Home]命令安装插件,例如:

./plugin.sh -install Java -P 1001 –appType tomcat –appHome /usr/lib/tomcat/apache-tomcat-7.0.63

其中:

  •  -P参数用于指定端口,对于本来没有端口的插件,指定端口可以标识插件的唯一性。同一插件可以通过指定不同的端口安装多个,当然您也可以不指定端口,安装时直接执行./plugin.sh -install Java命令即可。

  •  -appType和-appHome分别用于设置Java插件需要绑定的Web容器的名称和路径,不同容器需要提供的路径(即appHome)是不一样的,详细说明见下表。

容器

appHome说明

Tomcat

需要配置Tomcat安装路径:-appHome   <Tomcat_home>

JBoss

需要配置Tomcat安装路径:-appHome   <JBoss_home>

Weblogic

需要配置Weblogic启动文件(startWebLogic.sh)的路径:

-appHome   <WebLogic_home>/user_projects/domains/<mydomain>/bin

Jetty

需要配置Jetty安装路径:-appHome   <Jetty_home>

WebSphere

需要配置WebSphere应用程序服务器中待监控服务器的server.xml文件的路径:

-appHome   <WebSphere_home>/profiles/<appsrv-name>/config/cells/<cell-name>/nodes/<node-name>/servers/<server-name>

Resin

需要配置Resin安装路径:-appHome   <Resin_home>

Karaf

需要配置Karaf安装路径:-appHome   <Karaf_home>

 

绑定Web容器后,安装插件时会自动配置Web容器,可有效防止手动配置时出现错误。您也可以不绑定Web容器,即不指定-appType和-appHome两个参数。

如果安装时不绑定Web容器,您需要手动配置Web容器,详细说明见“配置Web容器”。


Docker容器中部署Java插件

Java插件还支持在Docker容器中进行安装部署,具体部署方式如下:

首先,将原始的Java插件解压到Docker镜像中的/data/javaagent或/opt/javaagent目录,重新打包镜像并在启动时使用带有Java插件的镜像。

然后,在tomcat/bin/catalina.sh中配置启动参数,详细说明见“手动配置Tomcat”。配置完成后,启动Tomcat,因为启动顺序的不同,具体操作会有些许不同。

  • Tomcat不随Docker 启动

需要在启动Tomcat 前先执行以下命令,然后再启动Tomcat。

./javaagent.sh startindocker
  • Tomcat随Docker启动

需要在DockerFile中的CMD添加执行以下命令,然后再启动Tomcat。

sh javaagent.sh startindocker

注意事项:

请按顺序执行操作,在启动javaagent.sh  startindocker命令前,需确定宿主机的SmartAgent已经启动。

因为javaagent.sh 脚本在执行startindocker时,会读取hosts文件中主机名最后一行,从而判断宿主机在局域网的IP地址,并从宿主机同步 hostkey 以及修改javaagent/conf/app.conf中的转发地址(SendProxy所在宿主机),同步的hostkey是由SmartAgent提供的。


配置Java插件

安装Java插件后,您可以通过以下两种方式配置插件:

逐个配置

执行./plugin.sh -config Java -P [Port]命令,通过配置引导逐步配置插件配置插件,例如:

./plugin.sh -config Java -P 1001

 安装插件时未指定端口时,直接执行./plugin.sh -config Java命令即可。

按照配置引导的提示,确认配置项后输入对应的序号,查看当前配置项的值并输入新的值。配置完成后,输入对应序号保存配置并退出配置引导。

批量配置

您还可以在执行./plugin.sh -config Java -P [Port]命令时,通过指定参数名称和参数值直接配置插件的多个配置项,例如:

./plugin.sh -config Java -P 1001 -a ERP_Purchase -cp com.neu.* -ot true

安装插件时未指定端口时,直接执行./plugin.sh -config Java命令并配置参数即可。

其中:

  • “-a”用于配置:appname

  • “-dt”用于配置:dumpThread

  • “-cp”用于配置:count_pack

  • “-jp”用于配置:jvm_period

  • “-rt”用于配置:reloadTime

  • “-btetl”用于配置:backendTaskExecTimeLimit

  • “-f”用于配置:frequency

  • “-param”用于配置:param

  • “-hte”用于配置:http.trace.exclude

  • “-pi”用于配置:packg.include

  • “-sp”用于配置:sqlParam

  • “-p”用于配置:protocol

  • “-uh”用于配置:udpHost

  • “-up”用于配置:udpPort

各配置项的详细说明请参考“配置Java插件”。

配置Web容器

除配置Java插件,您还需要配置Web容器。如果安装Java插件时绑定了Web容器请忽略本步;如果未绑定Web容器,您需要手动配置Web容器,详细说明见“配置Web容器”。

重启Web容器

为保证配置生效并避免出错,您需要重启绑定的Web容器,如Tomcat。