ManageEngine® Applications Manager Installing APM Insight Java Agent |
||
APM Insight relies on the agent-based instrumentation technology for data aquisition and transmission.
Web Components supported: JSP, Servlets, EJB
Web Frameworks supported: Struts
ORM Frameworks supported: Hibernate, Spring, iBATIS
Note: APM Insight Java Agent works in Application Servers running with Java 1.5 or above. |
This section covers the following topics on installing the APM Insight Java Agent:
Extract the zip to find apminsight-javaagent.jar and it's configuration file apminsight.conf
Create a new directory and move the two files there. The created directory should have read and write permission. For example: D:\apminsight\
Navigate to Configure Tomcat --> JAVA tab and add JavaAgent entry -javaagent:"<absolute_path_of_created_directory>/apminsight-javaagent.jar"
(example: -javaagent:"D:\apminsight\apminsight-javaagent.jar") in Java Options box as shown below.
The Apache Tomcat Properties Window can also be accessed by right clicking Tomcat Icon in system tray and selecting the Configure option.
After adding the Java Agent entry, click on Apply. Then click OK.
Open the apminsight.conf file with a text editor and configure the values for the agent to work.
To know more about configuration go to the APM Insight Java Agent Configuration Options page.
Extract the zip file to find apminsight-javaagent.jar and it's configuration file apminsight.conf.
Create a new directory and move the two files there. The new directory should have read and write permission.
For windows, open catalina.bat in the bin folder using a text editor and add the following entry at the top of the catalina.bat file and save it.
SET JAVA_OPTS=%JAVA_OPTS% -javaagent:"<absolute_path_of_created_directory>/apminsight-javaagent.jar"
Example: SET JAVA_OPTS=%JAVA_OPTS% -javaagent:"D:/apminsight/apminsight-javaagent.jar"
For linux, open catalina.sh in bin folder using a text editor and add the following entry at the top of the catalina.sh file and save it
export JAVA_OPTS="$JAVA_OPTS -javaagent:<absolute_path_of_created_directory>/apminsight-javaagent.jar"
Example: export JAVA_OPTS="$JAVA_OPTS -javaagent:/home/local/softwares/apminsight/apminsight-javaagent.jar"
Open the apminsight.conf file with a text editor and configure the values for the agent to work.
To know more about configuration go to the APM Insight Java Agent Configuration Options page.
APM Insight Java Agent can be deployed in Websphere through Admin Console as follows:
Extract the zip to find apminsight-javaagent.jar and it's configuration file apminsight.conf
Create a new directory and move the two files there. The new directory should have read and write permission.
Login as admin in the WebSphere console.
Expand Servers tree option in the left and click on Application Servers
Select the Server in which you are going to install the java agent
Under Server Infrastructure, expand JAVA and Process Management and click on Process Definition.
Under Additional Properties, Click on Java Virtual Machine
In Generic JVM arguments box add the following line:
-javaagent:"<absolute_path_of_created_directory>/apminsight-javaagent.jar"
Example1: -javaagent:"D:/apminsight/apminsight-javaagent.jar"
Example2: -javaagent:"/home/local/softwares/apminsight/apminsight-javaagent.jar"
If more statements are found in the box, use blank space as separator.
Click on Apply and then Save.
Open the apminsight.conf file with a text editor and configure the values for the agent to work.
To know more about configuration go to the APM Insight Java Agent Configuration Options page.
Extract the zip file to find apminsight-javaagent.jar and it's configuration file apminsight.conf
Create a new directory and move the two files there. The created directory should have read and write permission
For windows, open run.bat in bin folder using a text editor and add the following entry at the top of the run.bat file and save it:
SET JAVA_OPTS=%JAVA_OPTS% -javaagent:"<absolute_path_of_created_directory>/apminsight-javaagent.jar"
Example: SET JAVA_OPTS=%JAVA_OPTS% -javaagent:"D:/apminsight/apminsight-javaagent.jar"
For linux,open run.sh in bin folder using a text editor and add the following entry at the top of the run.sh file and save it
export JAVA_OPTS="$JAVA_OPTS -javaagent:<absolute_path_of_created_directory>/apminsight-javaagent.jar"
Example: export JAVA_OPTS="$JAVA_OPTS -javaagent:/home/local/softwares/apminsight/apminsight-javaagent.jar"
Open the apminsight.conf file with a text editor and configure the values for the agent to work.
To know more about configuration go to the APM Insight Java Agent Configuration Options page.
Extract the zip to find apminsight-javaagent.jar and it's configuration file apminsight.conf
Create a new directory and move the two files there. The created directory should have read and write permission.
For windows, open startWLS.bat in bin folder using a text editor and add the following entry at the top of the startWLS.bat file and save it
SET JAVA_OPTS=%JAVA_OPTS% -javaagent:"<absolute_path_of_created_directory>/apminsight-javaagent.jar"
Example: SET JAVA_OPTS=%JAVA_OPTS% -javaagent:"D:/apminsight/apminsight-javaagent.jar"
For linux, open startWLS.sh in bin folder using a text editor and add the following entry at the top of the startWLS.sh file and save it
export JAVA_OPTS="$JAVA_OPTS -javaagent:<absolute_path_of_created_directory>/apminsight-javaagent.jar"
Example: export JAVA_OPTS="$JAVA_OPTS -javaagent:/home/local/softwares/apminsight/apminsight-javaagent.jar"
Open the apminsight.conf file with a text editor and configure the values for the agent to work.
To know more about configuration go to the APM Insight Java Agent Configuration Options page.
Extract the zip to find apminsight-javaagent.jar and it's configuration file apminsight.conf
Create a new directory and move the two files there. The created directory should have read and write permission
For windows, open <your application server startup scipt>.bat using a text editor and add the following entry at the top of the startup script and save it
SET JAVA_OPTS=%JAVA_OPTS% -javaagent:"<absolute_path_of_created_directory>/apminsight-javaagent.jar"
Example: SET JAVA_OPTS=%JAVA_OPTS% -javaagent:"D:/apminsight/apminsight-javaagent.jar"
For linux, Open <your application server startup scipt>.sh using a text editor and add the following entry at the top of the startup script and save it
export JAVA_OPTS="$JAVA_OPTS -javaagent:<absolute_path_of_created_directory>/apminsight-javaagent.jar"
Example: export JAVA_OPTS="$JAVA_OPTS -javaagent:/home/local/softwares/apminsight/apminsight-javaagent.jar"
Open the apminsight.conf file with a text editor and configure the values for the agent to work.
To know more about configuration go to the APM Insight Java Agent Configuration Options page.
For troubleshooting tips, go to our Support Portal.
Note: |
How does APM Insight work? |
Ruby Agent |