All Products
Search
Document Center

Application Real-Time Monitoring Service:Migrate from arms-pilot to ack-onepilot

Last Updated:Mar 11, 2026

The arms-pilot Application Monitoring agent is no longer maintained. Its replacement, ack-onepilot, is fully compatible and requires no changes to your application configurations. This guide covers uninstalling arms-pilot and installing ack-onepilot on an ACK cluster.

Important

You must uninstall arms-pilot before you install ack-onepilot. If both agents are present in the cluster, the ARMS agent cannot mount. If any arms-pilot resources remain, ack-onepilot detects them and does not start.

Prerequisites

Before you begin, make sure that you have:

  • An ACK cluster running Kubernetes V1.16 or later. If your cluster runs an earlier version, update the Kubernetes version first

  • A record of your current arms-pilot configurations. These are not automatically carried over to ack-onepilot and must be manually re-applied after installation

Uninstall arms-pilot

  1. Log on to the ACK console. On the Clusters page, click the name of your cluster.

  2. In the left-side navigation pane, choose Applications > Helm.

  3. On the Helm page, find arms-pilot and click Delete in the Actions column.

  4. In the Delete dialog box, click OK.

Verify the uninstallation

  1. In the left-side navigation pane, choose Workloads > Deployments.

  2. On the Deployments page, select arms-pilot from the Namespace drop-down list.

    Note

    If you previously changed the namespace for arms-pilot, select that namespace instead.

  3. Confirm that all pods in the namespace have been deleted.

Important

Do not proceed to the next step until all arms-pilot resources are removed. Remaining resources prevent ack-onepilot from starting.

Install ack-onepilot

  1. Log on to the ACK console. On the Clusters page, click the name of your cluster.

  2. In the left-side navigation pane, click Add-ons.

  3. On the Add-ons page, search for ack-onepilot and click Install on its card.

  4. In the dialog box, configure the parameters and click OK. The default values work for most clusters. ack-onepilot resource requirements scale with the number of pods in the cluster:

    Pods in clusterCPU (cores)Memory
    Up to 1,000DefaultDefault
    Each additional 1,000+0.5+512 MB
  5. Re-apply any arms-pilot configurations that you recorded in the prerequisites step.

After installation, you can upgrade, configure, or uninstall ack-onepilot from the Add-ons page.

Verify the installation

  1. In the left-side navigation pane, choose Workloads > Deployments.

  2. On the Deployments page, select ack-onepilot from the Namespace drop-down list.

  3. Confirm that all pods in the namespace are running.

Verify ack-onepilot pods are running