After you install the Application Real-Time Monitoring Service (ARMS) agent for a
Java application, ARMS starts to monitor the Java application. Then, you can view
the monitoring data of the Java application, such as the application topology, traces,
abnormal transactions, slow transactions, and SQL analysis. You can install the ARMS
agent manually or by using scripts. This topic shows you how to manually install the
ARMS agent for a Java application.
Procedure
- Log on to the ARMS console.
- In the left-side navigation pane, choose . In the top navigation bar, select a region.
- On the Applications page, click Add Application in the upper-right corner.
- On the Add Application page, perform the following operations:
- Select Java as the programming language of your application.
- Select Default as the environment where your application is deployed.
- Select Install Manually as the method to install the ARMS agent.
- Download the ARMS agent and click Next in the Download Agent step on the Add Application page. You can use one of the following methods to download the ARMS agent:
- Method 1: Manually download the ARMS agent. In the Download Agent step, click Download Agent.
- Method 2: Run the wget command. Download the installation package based on your region.
Note Use the public endpoint. If the download fails, use the VPC endpoint.
| Region list |
Public endpoint |
VPC endpoint |
| China (Hangzhou) |
wget "http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
| China (Shanghai) |
wget "http://arms-apm-shanghai.oss-cn-shanghai.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-shanghai.oss-cn-shanghai-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
| China (Qingdao) |
wget "http://arms-apm-qingdao.oss-cn-qingdao.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-qingdao.oss-cn-qingdao-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
| China (Beijing) |
wget "http://arms-apm-beijing.oss-cn-beijing.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-beijing.oss-cn-beijing-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
| China (Zhangjiakou) |
wget "http://arms-apm-zhangjiakou.oss-cn-zhangjiakou.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-zhangjiakou.oss-cn-zhangjiakou-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
| China (Shenzhen) |
wget "http://arms-apm-shenzhen.oss-cn-shenzhen.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-shenzhen.oss-cn-shenzhen-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
| China (Hong Kong) |
wget "http://arms-apm-hongkong.oss-cn-hongkong.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-hongkong.oss-cn-hongkong-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
| Singapore |
wget "http://arms-apm-ap-southeast.oss-ap-southeast-1.aliyuncs.com/cloud_ap-southeast-1/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-ap-southeast.oss-ap-southeast-1-internal.aliyuncs.com/cloud_ap-southeast-1/ArmsAgent.zip" -O ArmsAgent.zip
|
| Japan (Tokyo) |
wget "http://arms-apm-japan.oss-ap-northeast-1.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-japan.oss-ap-northeast-1-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
| US (Silicon Valley) |
wget "http://arms-apm-usw.oss-us-west-1.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-usw.oss-us-west-1-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
| China East 1 Finance |
wget "http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/finance/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/finance/ArmsAgent.zip" -O ArmsAgent.zip
|
| China East 2 Finance |
wget "http://arms-apm-sh-finance-1.oss-cn-shanghai-finance-1.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "http://arms-apm-sh-finance-1.oss-cn-shanghai-finance-1-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
| China South 1 Finance |
wget "http://arms-apm-sz-finance.oss-cn-shenzhen-finance-1.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
wget "https://arms-apm-sz-finance.oss-cn-shenzhen-finance-1-internal.aliyuncs.com/ArmsAgent.zip" -O ArmsAgent.zip
|
- Go to the directory of the installation package. Run the following command to decompress
the installation package to a working directory:
unzip ArmsAgent.zip -d /{user.workspace}/
Note {user.workspace} is a sample directory. Replace it with an actual directory.
- Copy the license key in the upper part of the Add Application page.
- Use one of the following methods to add the AppName and LicenseKey parameters:
Note Replace {LicenseKey} in the sample code with your license key. Replace {AppName} with your application name. The application name cannot contain Chinese characters.
Replace {user.workspace} with the directory where the ARMS agent is decompressed. Replace demoApp.jar with
the path to the actual JAR package.
- Method 1: Edit the JVM parameters based on the runtime environment of your application.
| Runtime environment |
Procedure |
| Tomcat on Linux or macOS |
Append the following configurations to the {TOMCAT_HOME}/bin/setenv.sh file:
JAVA_OPTS="$JAVA_OPTS -javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName}"
If your Tomcat does not contain the setenv.sh configuration file, open the {TOMCAT_HOME}/bin/catalina.sh file and append the preceding configurations to the JAVA_OPTS parameter. For more information, see Row 256 in the catalina.sh file.
|
| Tomcat on Windows |
Append the following configurations to the {TOMCAT_HOME}/bin/catalina.bat file:set "JAVA_OPTS=%JAVA_OPTS% -javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName}"
If the preceding setting does not take effect, append the following configurations
to the {TOMCAT_HOME}/bin/catalina.bat file:
set "CATALINA_OPTS=-javaagent:/{user.workspace}/arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName}"
|
| Jetty |
Append the following configurations to the {JETTY_HOME}/start.ini configuration file:
--exec
-javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar
-Darms.licenseKey={LicenseKey}
-Darms.appName={AppName}
|
| Spring Boot |
When you start the Spring Boot process, append the -javaagent parameter to the startup command:
java -javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName} -jar demoApp.jar
|
| Resin |
When you start the Resin process, append the following tag to the conf/resion.xml configuration file:
<server-default>
<jvm-arg>-javaagent:{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar</jvm-arg>
<jvm-arg>-Darms.licenseKey={LicenseKey}</jvm-arg>
<jvm-arg>-Darms.appName={AppName}</jvm-arg>
</server-default>
Append the following tag to the conf/app-default.xml file:
<library-loader path="{user.workspace}/ArmsAgent/plugin"/>
|
| Windows |
When you run a CMD command to start the Java process, use a backslash (\) as the delimiter
in the mount path of the ARMS agent.
java -javaagent:\{user.workspace}\ArmsAgent\arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName} -jar {user.workspace}\demoApp.jar
|
To deploy multiple instances of the same application on a server, you can differentiate
the JVM processes by setting the -Darms.agentId parameter to a logical number. Example:
java -javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName} -Darms.agentId=001 -jar demoApp.jar
- Method 2:
-
Append the following configurations to the arms-agent.config file:
arms.licenseKey={LicenseKey} arms.appName={AppName}
-
Append the following parameter to the startup script of the Java application:
-javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar
- Restart the Java application.
Verification
After about 1 minute, if your application is displayed in the application list and
some data records are sent, your application is monitored by ARMS.
Uninstall the ARMS agent
If you no longer need ARMS to monitor your Java application, perform the following
steps to uninstall the ARMS agent.
- Delete all parameters that you added in Step 8, such as {AppName} and {LicenseKey}.
- Restart the Java application.
