Help Center/ Cloud Eye/ User Guide/ Cloud Resource Monitoring/ Server Monitoring/ Cloud Eye Plug-in (Agent)/ Upgrading the Agent
Updated on 2026-06-18 GMT+08:00
View PDF
Share

Upgrading the Agent

The Cloud Eye Agent collects OS-level metrics from the target host, which is valuable for server monitoring. The Cloud Eye Agent regularly updates to add new features, fix stability issues, and optimize performance. If the current Agent version is not the desired one, you can upgrade the Agent. For details about the Agent version, see Agent Features per Version.

The Cloud Eye Agent will be continuously upgraded to provide you with a better monitoring experience. This section describes how to upgrade the Agent.

Constraints

You cannot upgrade the Agent in the following regions: CN South-Guangzhou-InvitationOnly and LA-Mexico City1.

Applicable Scenarios

Table 1 Applicable scenarios

Installation Method

Scenario

Constraints

Navigation Path

Automatically Upgrading Agents for All Servers

Cloud Eye supports automatic Agent upgrade on the management console. If you want to upgrade the Agents of all servers to the same version, you are advised to use the fully automated upgrade function to perform the upgrade for servers that support one-click installation.

After the Agent installation is complete, you can upgrade the Agent for servers that do not support one-click installation and those failed the automatic installation.

This method only applies to servers with the Agent installed and in the Running state.

Go to the Server Monitoring page of the Cloud Eye console. Choose Install & Upgrade the Agent > Install and Upgrade Agent on All Servers above the server list.

Automatically Upgrading the Agents for Selected Servers

Cloud Eye supports automatic Agent upgrade on the management console. If you only need to install the Agents for some servers that support one-click installation, or upgrade the Agents to different versions for different servers, you can use related functions on the console to automate the process.

Go to the Server Monitoring page of the Cloud Eye console. Choose Install & Upgrade the Agent > Batch Install and Upgrade Agent above the server list.

Manually Upgrading the Agent

For servers that do not support automatic upgrade using one-click installation or those failed the automatic upgrade, you can manually upgrade the Agents for them.

For details about the OSs that support one-click Agent installation, see What OSs Does the Agent Support?

None

Log in to a server.

Automatically Upgrading Agents for All Servers

  1. Log in to the Cloud Eye console.
  2. In the navigation pane, choose Server Monitoring > Elastic Cloud Server.
  3. Choose Install & Upgrade the Agent > Install and Upgrade Agent on All Servers. The Agent installation and upgrade guide will be displayed on the right.
  4. In the Agent installation and upgrade guidelines, select Upgrade the Agent.
  5. Select the target Agent edition.
    • Basic edition provides basic OS monitoring metrics, including CPU, memory, file system, disk, NIC, and network metrics.
    • Enhanced edition provides GPU and BMS hardware monitoring, in addition to the capabilities provided in the basic edition.
  6. Click OK.
  7. Check the upgrade results.
    1. In the navigation pane, choose Task Center.
    2. In the right pane, click the Agent Maintenance tab to view the upgrade task status.
      • If Status is Successful, the Agents are upgraded. In the server monitoring list, the Agent version of the target servers is the latest.
      • If Status is Timeout, click Retry in the Operation column.

Automatically Upgrading the Agents for Selected Servers

  1. Log in to the Cloud Eye console.
  2. In the navigation pane, choose Server Monitoring > Elastic Cloud Server.
  3. In the server list, select the servers you want to upgrade.
  4. Choose Install & Upgrade the Agent > Batch Install and Upgrade Agent. The Agent installation and upgrade guide will be displayed on the right.
  5. On the Batch Modify Servers page, check the servers with ongoing tasks.

    If the system detects any objects that cannot be executed, see Why Cannot I Install or Upgrade Agents in Batches? for a solution.

  6. Click Next.
  7. In the Agent installation and upgrade guidelines, select Upgrade the Agent.
  8. Select the target Agent edition.
    • Basic edition provides basic OS monitoring metrics, including CPU, memory, file system, disk, NIC, and network metrics.
    • Enhanced edition provides GPU and BMS hardware monitoring, in addition to the capabilities provided in the basic edition.
  9. Click OK.
  10. Check the upgrade results.
    1. In the navigation pane, choose Task Center.
    2. In the right pane, click the Agent Maintenance tab to view the upgrade task status.
      • If Status is Successful, the Agents are upgraded. In the server monitoring list, the Agent version of the target servers is the latest.
      • If Status is Timeout, click Retry in the Operation column.

Manually Upgrading the Agent

For servers that do not support one-click installation or those failed the automatic upgrade, you must run the script to manually upgrade the Agents for them. You need to uninstall the Agent of an earlier version before installing a later one.

  1. Log in to an ECS as user root.
  2. Run the following command to check whether the current Agent is Uniagent or telescope: 
    if [[ -f /usr/local/uniagent/extension/install/telescope/bin/telescope ]]; then /usr/local/uniagent/extension/install/telescope/bin/telescope -v; elif [[ -f /usr/local/telescope/bin/telescope ]]; then echo "old agent"; else echo 0; fi
    • If old agent is returned, the Agent of an earlier version (telescope) is used.
    • If a version ID is returned, the Agent of the new version (Uniagent) is used.
    • If 0 is returned, the Agent is not installed.
  3. Uninstall the Agent.
    • Earlier version: If old agent is returned in 2, run the command in Earlier Version.
    • New version: If a version number is returned in 2, run the command in New Version.
  4. Install the Agent of the latest version by running the command in Installing the Agent on a Single Server.
  1. Log in to the Windows ECS as an administrator.
  2. Determine the current Agent version based on the Agent installation path.
    • New version: C:\Program Files\uniagent\extension\install\telescope
    • Earlier version: C:\Program Files\telescope
  3. Uninstall the current Agent by running the command in Uninstalling the Agent.
  4. Install the Agent of the latest version by running the command in Installing the Agent on a Single Server.
Parent Topic: Cloud Eye Plug-in (Agent)