Install APM Insight Java Agent in JBoss AS 4.2.x & above

  • Download latest the APM Insight java agent zip file ( here
  • Extract the zip file to a new directory to find agent jar and its configuration files
  • Open the apminsight.conf file in any text editor and include the following keys:
    license.key=[LICENSE KEY][HOST]:[PORT]/


    To learn more about the configurations, visit our Configuration Guide page.
  • For JBoss AS 4.x, 5.x, 6.x servers:
    • For Windows, open <JBOSS_HOME>\bin\run.bat in any text editor and add the following entry at the top and save it.
    set JAVA_OPTS=-javaagent:<agent_directory_full_path>/apminsight-javaagent.jar %JAVA_OPTS%
    • For Linux, open <JBOSS_HOME>/bin/ in any text editor and add the following entry at the top and save it.
    export JAVA_OPTS="$JAVA_OPTS -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar"
  • For JBoss AS 7.x servers:
    • In standalone setup: Edit <JBOSS_HOME>/bin/standalone.bat (In Linux, file to add the following java arguments to the existing JAVA_OPTS.
-Djboss.modules.system.pkgs=org.jboss.byteman,com.manageengine -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar
    • In domain setup: Edit <JBOSS_HOME>/domain/configuration/Host.xml file and locate <servers> tag and add the mentioned tags under your desired .
<property name="jboss.modules.system.pkgs" value="org.jboss.byteman,com.manageengine" boottime="true"/>
<jvm name="insight">
<option value="-javaagent:<agent_directory_full_path>/apminsight-javaagent.jar" />
  • Save the file and start the JBoss Application Server

There is a bug in JBoss AS 7.2.x with a hindrance to deploy our APM Insight Java Agent in this server. We suggest to upgrade the JBoss server and try installing APMInsight Agent.