Help Center/ Application Operations Management/ User Guide/ Connecting to AOM/ Managing Collector Base UniAgent/ Managing UniAgents and ICAgents in CCE Clusters
Updated on 2025-07-01 GMT+08:00
View PDF
Share

Managing UniAgents and ICAgents in CCE Clusters

Kubernetes cluster management allows you to manage the lifecycle of UniAgents and ICAgents on hosts in your purchased CCE clusters, for example, batch installation, upgrade, and uninstall.

Prerequisites

Viewing the CCE Clusters Connected to AOM

  1. Log in to the AOM 2.0 console.
  2. In the navigation pane on the left, choose Settings > Global Settings.
  3. In the navigation pane, choose Collection Settings > K8s Clusters.
  4. On the K8s Clusters page, check the CCE clusters connected to AOM.

    • Enter a CCE cluster name or ID in the search box to search for a cluster. Fuzzy match is supported.
    • To collect container logs and output them to AOM 1.0, enable Output to AOM 1.0. (This function is supported only by ICAgent 5.12.133 or later.) You are advised to collect container logs and output them to LTS instead of AOM 1.0. For details, see Ingesting CCE Application Logs to LTS.

Managing the UniAgents of CCE Clusters

You can install, upgrade, and uninstall UniAgent on hosts in CCE clusters connected to AOM.

  1. Log in to the AOM 2.0 console.
  2. In the navigation pane on the left, choose Settings > Global Settings.
  3. On the Global Settings page, choose Collection Settings > K8s Clusters in the navigation pane.
  4. On the displayed page, select the target cluster from the cluster list and perform the operations listed in the following table if needed.

    Table 1 Operations on UniAgents

    Operation

    Description

    Install UniAgent
    1. Click Install UniAgent and select a UniAgent version to install.
    2. Click OK. The UniAgent of the specified version and the ICAgent of the latest version will be installed on all hosts of the cluster.

    Upgrade UniAgent
    1. Click Upgrade UniAgent and select a UniAgent version to upgrade.
    2. Click OK. The UniAgents on all hosts of the cluster will be upgraded to the version you specified.

    Uninstall UniAgent
    1. Click Uninstall UniAgent. On the displayed page, click OK. The UniAgents will be uninstalled from all hosts of the cluster. ICAgents will also be uninstalled if there are any.

      Only the UniAgents installed on the K8s Clusters page can be uninstalled here.

Managing ICAgents in CCE Clusters

You can install, upgrade, and uninstall ICAgents on hosts in CCE clusters connected to AOM.

  1. Log in to the AOM 2.0 console.
  2. In the navigation pane on the left, choose Settings > Global Settings.
  3. On the Global Settings page, choose Collection Settings > K8s Clusters in the navigation pane.
  4. On the K8s Clusters page, select the cluster where you want to perform ICAgent operations and click Plug-in Operations.

    Plug-in operations are supported only when your UniAgent has been installed through the K8s Clusters page. If your UniAgent is not installed through the K8s Clusters page, click Install UniAgent to install the UniAgent on the hosts in your CCE cluster before performing plug-in operations.

  5. In the displayed dialog box, select the operations listed in the following table if needed.

    Table 2 Plug-in operations

    Operation

    Description

    Install
    1. Select the Install operation and ICAgent plug-in. (Only the ICAgent can be installed.)
    2. Click OK. The ICAgent of the latest version will then be installed on all hosts that meet criteria.

    Upgrade
    1. Select the Upgrade operation and ICAgent plug-in. (Only the ICAgent can be upgraded.)
    2. Click OK. The ICAgent on all hosts that meet criteria will then be upgraded to the latest version.

    Uninstall
    1. Select the Uninstall operation and ICAgent plug-in. (Only the ICAgent can be uninstalled.)
    2. Click OK. The ICAgent will then be uninstalled from all hosts that meet criteria.