安装配置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。