After you install the Application Real-Time Monitoring Service (ARMS) agent for a Java application that is deployed in Container Service for Kubernetes (ACK), ARMS starts to monitor the Java application. You can view the monitoring data of application topology, API requests, abnormal transactions, and slow transactions. This topic describes how to install the ARMS agent for a Java application that is deployed in ACK.
Prerequisites
- An ACK cluster is created. For more information, see Create an ACK dedicated cluster or Create an ACK managed cluster.
- Manage namespaces: A namespace is created in the ACK cluster. The namespace in this example is arms-demo.
- The JDK version is not 1.8.0_25 or 1.8.0_31. Otherwise, the ARMS agent may fail to be installed. If the installation fails, update the JDK version to 1.8.X.
Step 1: Install the ARMS agent
Install the ARMS agent that is named ack-arms-pilot.
- Log on to the ACK console.
- In the left-side navigation pane, choose ack-arms-pilot. . On the Alibaba Cloud Apps tab, click
- In the Deploy section of the View Details page of ack-arms-pilot, select the cluster where the application to be monitored is deployed and click Create.
Step 2: Enable ARMS for a Java application
When you use the ack-arms-pilot agent to create an ARMS instance, ARMS performs password-free authorization if the image version of ack-arms-pilot is V1.30 or later and ARMS Addon Token is enabled for the ACK cluster. Otherwise, you must manually grant access permissions on ARMS resources to ACK.
Only managed Kubernetes clusters and serverless Kubernetes (ASK) clusters support ARMS Addon Token. Therefore, you need to manually grant access permissions to clusters of other types. ARMS Addon Token may not be enabled for some managed Kubernetes clusters and serverless Kubernetes(ASK) clusters. We recommend that you check whether the ARMS Addon Token are enabled for managed Kubernetes clusters and ASK clusters. If ARMS Addon Token is not enabled, you must manually enable it.
For information about how to view the arms-pilot image version and ARMS Addon Token, see How do I view the image version of ack-arms-pilot? and How do I check whether a cluster has ARMS Addon Token enabled? .
Execution result
On the Deployments tab, find the application and check whether the ARMS Console button appears in the Actions column.

Uninstall the ARMS agent
- Log on to the Alibaba Cloud Container Service for Kubernetes console.
- In the left-side navigation pane, click Clusters. On the Clusters page, find the cluster that contains the Java application from which you want to uninstall the ARMS agent and click Applications in the Actions column.
- In the left-side navigation pane, choose .
- On the Helm tab, find the release named arms-pilot of the ARMS agent, and click Delete in the Actions column.
- In the Delete message, click OK.
- Restart your business pod.
FAQ
How do I change the name of an application?
To change the name of an application, you must modify the armsPilotCreateAppName parameter in the Deployment application. For more information, see FAQ about application monitoring.
How do I view the image version of ack-arms-pilot?
- Log on to the ACK console.
- On the Clusters page, find the instance that you want to manage and click the instance ID.
- In the left-side navigation pane of the details page, choose .
- In the upper part of the page, select arms-pilot from the Namespace drop-down list to view the image version of the arms-pilot-ack-arms-pilot instance.
How do I check whether ARMS Addon Token is enabled for a cluster?
- Log on to the ACK console.
- On the Clusters page, find the instance that you want to manage and click the instance ID.
- In the left-side navigation pane, choose .
- In the upper part of the page, select kube-system from the Namespace drop-down list to check whether addon.arms.token is enabled.
Why does ARMS Agent fail to be installed?
Solution: Grant ACK the permissions to access ARMS.
How do I report data across regions?
- In the Deployment application that is deployed in the arms-pilot namespace of the ACK cluster, add the ARMS_REPORT_REGION environment variable. The value must be an ID of the region where ARMS is available. For example, you can set the value to cn-hangzhou or cn-beijing.
- Restart the existing application or deploy a new application to report data across
regions.
Note After the environment variable is added, all applications that are deployed in the cluster report data to the specified region.