Connect ARMS to an ACK Serverless cluster

Integrating Application Real-Time Monitoring Service (ARMS) with an Alibaba Cloud ACK Serverless cluster provides a unified way to manage your distributed Kubernetes clusters. This topic describes how to connect ARMS to a standard ACK Serverless cluster.

Step 1: Install the ARMS monitoring component

Before you install the ARMS monitoring component, check whether your ACK Serverless cluster has an ARMS Addon Token. If the token exists, ARMS uses passwordless authorization. Otherwise, you must provide an accessKey and accessKeySecret during installation for authorization.

Check whether ARMS Addon Token exists in a cluster

Log on to the ACK console. In the left-side navigation pane, click Clusters. On the Clusters page, click the name of the cluster to go to the cluster details page.
In the left-side navigation pane, choose Configurations > Secrets. In the upper part of the page, select kube-system from the Namespace drop-down list and check whether addon.arms.token is displayed on the Secrets page.

Procedure

Complete authorization on the RAM Quick Authorization page.
Log on to the ACK console. In the left navigation pane, click Clusters.
On the Clusters page, click the name of your cluster. In the left navigation pane, click Components and Add-ons.
On the Add-ons page, click the Logs and Monitoring tab. In the ack-onepilot card, click Install.

In the Install ack-onepilot dialog box, configure the parameters and click OK.

If the ACK Serverless cluster does not have an ARMS Addon Token, you must set accessKey and accessKeySecret. You can configure other parameters as needed. We recommend that you use the default settings.

Parameter	Description
accessKey	The AccessKey ID of your Alibaba Cloud account. The account must have permissions to access ARMS.
accessKeySecret	The AccessKey secret of your Alibaba Cloud account.

Step 2: Enable ARMS for a Java application

Log on to the ACK console. In the left-side navigation pane, click Clusters.
On the Clusters page, find the cluster that you want to manage and click its name. In the left-side navigation pane, choose Workloads > Deployments.
On the Deployments page, choose > Edit YAML in the Actions column of the target application.

To create a new application, click Create Resources Using YAML.
Add the following labels under the spec.template.metadata level in the YAML file.
```
labels:
  armsPilotAutoEnable: "on"
  armsPilotCreateAppName: "<your-deployment-name>"    # Replace <your-deployment-name> with the name of your application.
  aliyun.com/app-language: java
```
Note
- For more information about application security, see What is Application Security?.
- For more information about application security billing, see Billing.
Click Update.

On the Deployments page, choose > ARMS Console in the Actions column of the target application to view application monitoring details.

On the Deployments page, click ARMS Console in the Actions column of the target application to open the ARMS console and perform service governance.

Next steps

Uninstall the agent for all applications
1. Log on to the ACK console. On the Clusters page, click the name of the cluster.
2. In the left-side navigation pane, choose Operations > Add-ons. In the search box, enter ack-onepilot.
3. On the ack-onepilot card, click Uninstall.
4. In the message that appears, click OK.
5. Restart your business pod.
Uninstall the agent for a specific application
1. In the left-side navigation pane of the ACK console, choose Cluster. On the Clusters page, find the target cluster and click Manage Applications in the Actions column.
2. On the Deployments page, find the target application and choose More > View in YAML in the Actions column.
3. In the Edit YAML dialog box, remove the labels that you added in Step 2 to install the agent, and then click Update.
4. Restart the Pods.