在JBoss AS 4.2.x及更高版本中安装APM Insight Java代理


  • 在此处下载最新的APM Insight Java代理zip文件(apminsight-javaagent.zip
  • 将zip文件解压缩到新目录以查找代理jar及其配置文件
  • 在任何文本编辑器中打开apminsight.conf 文件,并包含以下键:
    license.key=[LICENSE KEY]
    apm.host=https://[HOST]:[PORT]/

    示例:

    license.key=APMI_74447444b666d7ab5174cc3021a9b68dd4b3364d50f99c2969360810313e8fac
    apm.host=https://app-w8-test:8443/
    要了解有关配置的更多信息,请访问我们的配置指南页面。
  • 对于JBoss AS 4.x,5.x,6.x服务器:
    • 对于Windows,在任何文本编辑器中打开<JBOSS_HOME>\bin\run.bat,并在顶部添加以下条目并保存。
    set JAVA_OPTS=-javaagent:<agent_directory_full_path>/apminsight-javaagent.jar %JAVA_OPTS%
    • 对于Linux,在任何文本编辑器中打开<JBOSS_HOME>/bin/run.sh并在顶部添加以下条目并保存。
    export JAVA_OPTS="$JAVA_OPTS -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar"
  • 对于JBoss AS 7.x服务器:
    • 独立安装程序中:编辑<JBOSS_HOME>/bin/standalone.bat(在Linux中,standalone.sh)文件,将以下Java参数添加到现有的JAVA_OPTS中。
-Djboss.modules.system.pkgs=org.jboss.byteman,com.manageengine -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar
    • 域设置中:编辑JBOSS_HOME>/domain/configuration/Host.xml文件并找到<servers>标记,并在所需的下方添加提到的标记
<system-properties>
<property name="jboss.modules.system.pkgs" value="org.jboss.byteman,com.manageengine" boottime="true"/>
</system-properties>
<jvm name="insight">
<jvm-options>
<option value="-javaagent:<agent_directory_full_path>/apminsight-javaagent.jar" />
</jvm-options>
</jvm>
  • 保存文件并启动JBoss Application Server

注意
JBoss AS 7.2.x中存在一个错误,阻碍了在此服务器中部署APM Insight Java Agent。我们建议升级JBoss服务器并尝试安装APMInsight Agent。