Install APM Insight Java Agent on Tomcat - Applications Manager User Guide

Active Directory
management Manage, track, and secure Active Directory

Identity governance
and administrationOrchestrate user identity management and access controls for Zero Trust

Privileged access
managementControl and secure privileged access to critical enterprise systems

ADManager Plus
Active Directory, Microsoft 365, and Exchange management and reporting
ADAudit Plus
Hybrid AD, cloud, and file auditing; security; and compliance
ADSelfService Plus
Identity security with adaptive MFA, SSPR, and SSO
Exchange Reporter Plus
Reporting, auditing, and monitoring for hybrid Exchange and Skype
RecoveryManager Plus
Active Directory, Microsoft 365, and Exchange backup and recovery

View all products

Install APM Insight Java Agent in Apache Tomcat 6.x & above

Download the latest APM Insight java agent zip file (apminsight-javaagent.zip) 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]
apm.host=http://[HOST]:[PORT]

Example:

license.key=APMI_74447444b666d7ab5174cc3021a9b68dd4b3364d50f99c2969360810313e8fac
apm.host=http://apm-prod-server:9090

To learn more about the agent configurations, visit our Configuration Guide page.

For Tomcat as non-service installation

On Windows:

Edit <TOMCAT_HOME>\bin\catalina.bat
Add the following entry to the top and save the file

set JAVA_OPTS=%JAVA_OPTS% -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar

On Linux:

Edit <TOMCAT_HOME>/bin/catalina.sh
Add the following entry to the top and save the file

#!/bin/sh
export JAVA_OPTS="$JAVA_OPTS -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar"

For Tomcat as service installation

Navigate to Configure Tomcat and click on the JAVA tab.
Note: If Configure Tomcat is not available or does not appear in the Windows taskbar search, run the tomcatw.exe (version-specific, e.g., tomcat9w.exe, tomcat10w.exe) script from the <TOMCAT_HOME>\bin directory.
Add the following entry in the Java Options box:
-javaagent:<agent_directory_full_path>/apminsight-javaagent.jar

Note: Replace <agent_directory_full_path> with the full directory path where the APM Insight Agent is installed.
After adding the entry, click Apply and then OK.
Start the Tomcat server.

Note:

You can also configure a secure APM URL. Ensure that the connection is stable and free from certificate-related issues.
Example: https://apm-prod-server:8443
For an Applications Manager failover setup, you can specify multiple hosts in a comma-separated format (supported from Java Agent v6.8), as shown below:
apm.host=http://apm-prod-server-A:9090, http://apm-prod-server-B:9090

Was this content helpful?

We are sorry. Help us improve this page.

How can we improve this page?

Need more information on this topic

Need better screenshots

Need clear step by step instructions

Others

Do you need assistance with this topic?

Yes No

By clicking "Submit", you agree to processing of personal data according to the Privacy Policy.

Identity and access management

Unified service management

Unified endpoint management and security

IT operations management and observability

Security information and event management

Advanced IT analytics

Low-code app development

Cloud solutions for enterprise IT

IT management for MSPs

Active Directory management Manage, track, and secure Active Directory

Identity governance and administrationOrchestrate user identity management and access controls for Zero Trust

Privileged access managementControl and secure privileged access to critical enterprise systems

Enterprise and IT service managementDeliver a consistent employee experience across business functions

Customer service managementBuild a one-stop portal for customers with efficient account management

IT asset managementCentralize and automate the complete IT asset life cycle

SIEM Spot, investigate, and neutralize security threats

Log and compliance managementGain deeper visibility into security events and ensure compliance

Security auditingAudit Active Directory, cloud platforms and files to enhance your security posture

Endpoint management and protection platform (UEM and EPP)Secure and manage endpoints to protect your IT assets effectively

Endpoint managementAchieve intelligent IT device management with zero user intervention

Endpoint securityDefend against threat actors with proactive and reactive measures

Full-stack observability and digital experience monitoringAchieve end-to-end visibility, proactive issue resolution, and enhanced security

Network and server performance monitoringEnsure network, server, and storage reliability with AI-powered insights

IT incident managementEfficiently manage and resolve IT incidents while ensuring transparency

DNS and DHCP managementOptimize IP address and domain management

Cloud cost managementRight-size and take control of your cloud costs

IT analyticsConnect to your IT applications and visualize all facets of your IT

Cloud-native solutions for IT managementMonitor, manage, audit, and secure your multi-cloudand hybrid infrastructure

Business applications for ITBoost productivity and improve team collaboration

Custom solution builderBuild tailor-made apps to automate operations at your organization

Solutions for MSPsGrow your MSP business with scalable and secure IT management solutions

Install APM Insight Java Agent in Apache Tomcat 6.x & above

How can we improve this page?

Do you need assistance with this topic?

Active Directory
management Manage, track, and secure Active Directory

Identity governance
and administrationOrchestrate user identity management and access controls for Zero Trust

Privileged access
managementControl and secure privileged access to critical enterprise systems

Enterprise and IT service
managementDeliver a consistent employee experience across business functions

Customer service
managementBuild a one-stop portal for customers with efficient account management

IT asset
managementCentralize and automate the complete IT asset life cycle

Network and server
performance monitoringEnsure network, server, and storage reliability with AI-powered insights

IT incident
managementEfficiently manage and resolve IT incidents while ensuring transparency

Cloud-native solutions for IT managementMonitor, manage, audit, and secure your multi-cloud
and hybrid infrastructure