Application Real-Time Monitoring Service:Uninstall the ARMS agent for Go

Uninstall from an ACK cluster

Uninstalling the ack-onepilot component removes the ARMS agent from all applications in the cluster.

kubectl get pods -n ack-onepilot

Uninstall from a single application in an ACK cluster

To remove the ARMS agent from a specific application without affecting other applications in the cluster:

1. Log on to the ACK console. On the Clusters page, find the target cluster and click Applications in the Actions column.

2. On the Deployments page, find the target application. In the Actions column, choose More > View in YAML.

3. In the Edit YAML dialog, delete the labels that were added when the ARMS agent was installed, then click Update.

4. Restart the application pod to apply the change.

kubectl get pod <pod-name> -n <namespace> --show-labels

Remove a manually installed agent

If you installed the ARMS agent by using instgo (compile-time instrumentation), remove it by recompiling your application with the standard Go toolchain. instgo automatically restores your codebase after compilation completes, so no code changes are needed.

1. (Optional) Recompile your application with go build instead of instgo:

   go build -o <your-app-binary>

2. Deploy the recompiled binary to your production environment, replacing the previously instrumented version.

Clean up residual files from compile-time instrumentation

During compile-time instrumentation, instgo temporarily modifies source files and restores them after compilation finishes. Manual cleanup is only needed if:

• The compilation was forcibly stopped or killed.

• instgo unexpectedly exited due to a panic.

Run the clean command to restore your source files:

./instgo clean

.\instgo.exe clean

Delete instgo and its cache

To fully remove instgo from your system:

1. Delete the agent cache directory. If you specified a custom cache directory with the --cacheDir flag during compilation, delete that directory. Otherwise, delete the default cache directory.

   Linux and macOS

   # Custom cache directory
   rm -rf <your-cache-dir>/aliyun-go-agent
   
   # Default cache directory
   rm -rf /opt/.opt/aliyun-go-agent

   Windows

   # Custom cache directory
   rmdir <your-cache-dir>\aliyun-go-agent -Recurse
   
   # Default cache directory
   rmdir C:\ProgramData\.opt\aliyun-go-agent -Recurse

2. Delete the instgo binary.