Installing the Agent
The Agent can collect metric data from the target host OS and send it to Cloud Eye for analysis. You can view such data in graphs to monitor metrics in real time. You can also set alarm rules for key metrics to quickly identify faults.
After the Agent is installed, Cloud Eye can provide proactive and fine-grained OS monitoring for servers. This section describes how to install the Agent automatically across all servers or using a custom method, as well as how to manually install it on a single server or in batches.
Applicable scenarios
Installation Method |
Scenario |
Constraints |
---|---|---|
Cloud Eye supports one-click Agent installation on the console. If you want to install the Agent for all servers in the server monitoring list, you are advised to choose this installation method. After the installation is complete, you can manually install the Agent for servers that do not support one-click installation or those failed automatic installation. |
Mainstream OSs support one-click installation. For details about supported OSs, see What OSs Does the Agent Support? |
|
Cloud Eye supports one-click Agent installation for servers on the console. If you only need to install the Agent for some servers that support one-click installation, you can use Cloud Eye to automate the process. |
||
If a server does not support or failed one-click installation, you can manually install the Agent for it. For details about supported OSs, see What OSs Does the Agent Support? |
None |
|
If you have multiple Linux servers in the same VPC and they do not support one-click installation, you can install the Agent for them in batches.
|
|
Automatically Installing the Agent on All Servers
- You have modified DNS server addresses and added security group rules. For details, see How Do I Configure DNS and Security Groups?
- You have configured an agency. For details, see How Do I Configure an Agency?
Procedure
- Log in to the Cloud Eye console.
- In the navigation pane, choose Server Monitoring > Elastic Cloud Server.
- Choose Install & Upgrade the Agent > Install and Upgrade Agent on All Servers. The Agent installation and upgrade guidelines will be displayed on the right pane.
Figure 1 Installing and upgrading the Agent on all servers
- Install the Agent as instructed.
- Select an installation method.
- Install or upgrade the Agent to the latest version on all ECSs: Install the Agent for all ECSs that support one-click installation but without the Agent installed, and upgrade the Agent for all ECSs with the Agent installed.
- Install the Agent: Install the Agent on all ECSs that support one-click installation but without the Agent installed.
- Upgrade the Agent: Upgrade the Agent for all ECSs with the Agent installed.
- Select an 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.
Install the Agent enhanced edition if you indeed need it, because it collects more metrics, which may occupy more server resources.
- Select an installation method.
- Click OK.
- Check the Agent installation results.
- In the navigation pane, choose Task Center.
- In the right pane, click the Agent Maintenance tab to view the task status.
- If Status is Successful, the Agent is installed. On the Server Monitoring page, check that the Agent status is Running and the Agent version is the latest.
- If Status is Timeout, click Retry in the Operation column.
Customizing the Automatic Agent Installation
- You have modified DNS server addresses and added security group rules. For details, see How Do I Configure DNS and Security Groups?
- You have configured an agency. For details, see How Do I Configure an Agency?
Procedure
- Log in to the Cloud Eye console.
- In the navigation pane, choose Server Monitoring > Elastic Cloud Server.
- Select the target servers and choose Install & Upgrade the Agent > Batch Install and Upgrade Agent. The Agent installation and upgrade guide will be displayed on the right.
Figure 2 Batch installing and upgrading the Agent
- On the Batch Modify Servers page, check the servers with ongoing tasks. If any inoperable servers are identified, rectify the fault by referring to Why Cannot I Install or Upgrade Agents in Batch?
- Click Next. The Install & Upgrade the Agent page is displayed.
- Select an installation method.
- Install or upgrade the Agent to the latest version on all ECSs: Install the Agent for all ECSs that support one-click installation but without the Agent installed, and upgrade the Agent for all ECSs with the Agent installed.
- Install the Agent: Install the Agent on all ECSs that support one-click installation but without the Agent installed.
- Upgrade the Agent: Upgrade the Agent for all ECSs with the Agent installed.
- Select an 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.
Install the Agent enhanced edition if you indeed need it, because it collects more metrics, which may occupy more server resources.
- Select an installation method.
- Click OK.
- Check the Agent installation results.
- In the navigation pane, choose Task Center.
- In the right pane, click the Agent Maintenance tab to view the task status.
- If Status is Successful, the Agent is installed. On the Server Monitoring page, check that the Agent status is Running and the Agent version is the latest.
- If Status is Timeout, click Retry in the Operation column.
Installing the Agent on a Single Server
Prerequisites
- You have modified DNS server addresses and added security group rules. For details, see How Do I Configure DNS and Security Groups?
- You have configured an agency. For details, see How Do I Configure an Agency?
- Ensure that you have the read and write permissions for the installation directory and the Telescope process is not stopped by other software after the installation (user root for Linux servers and user Administrator for Windows servers).
You can only use the administrator account to install the Cloud Eye Agent. Any improper use of this account may cause system stability or data security issues. Exercise caution when using this account.
Procedure
- Log in to the Cloud Eye console.
- In the navigation pane, choose Server Monitoring > Elastic Cloud Server.
- Click Install Manually above the server list. The installation guide is displayed on the right.
Figure 3 Agent installation guide
- Obtain the installation command.
- Select an OS for the server where the Agent is to be installed.
- Select Normal.
- Click
next to the installation command to copy the command.
- Log in to a server.
For Linux servers, see . For Windows servers, see Login Overview (Windows).
- Run the installation command obtained in 4.
- Linux: Run the installation command as the root user.
- Windows: Run the installation command as the Administrator user.
- Check the Agent installation results.
- Linux: If Telescope process starts successfully. is displayed, the installation is successful. Wait for 3 to 5 minutes until the Agent collects monitoring data.
- Windows: If the Agent status is Running, the Agent is installed and started.
Manually Installing the Agents in Batches
If multiple Linux servers are deployed in the same VPC and they do not support one-click installation, you can install the Agents for these servers in batches.
- Batch installation cannot be performed across regions.
- The servers where the Agent is to be installed in a batch must be in the same VPC.
- Agents cannot be installed on Windows servers in batches.
Prerequisites
- You have modified DNS server addresses and added security group rules. For details, see How Do I Configure DNS and Security Groups?
- You have configured an agency. For details, see How Do I Configure an Agency?
- There is one server with the Agent installed in the given VPC.
- You have obtained the login password or key of the root user for all servers.
To batch install the Agents, you can enter the IP address, port No., and root password or key of the servers on the management console, and then run the installation command.
- Log in to the Cloud Eye console.
- In the navigation pane, choose Server Monitoring > Elastic Cloud Server.
- Click Install Remotely to switch to the remote installation guide.
- Install the Agent as instructed.
- Select an 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.
- Select an installation server.
- In the given VPC, select the server with the Agent installed as the installation server. Then use this server to install Agents on other servers in the same VPC. If there is no such an installation server, you can locate a server and choose More > Set Installation Server in the Operation column.
- If none of the servers in the VPC has the Agent installed, select one to manually install the Agent. For details, see Installing the Agent on a Single Server.
- Set parameters for the servers for installing the Agent based on Table 2.
Figure 4 Remote installationTable 2 Parameters for configuring servers Parameter
Description
Example Value
Server IP Address
IP address of the server for remotely installing the Agent.
192.168.72.229
Login Username
Account for logging in to the server. The default value is root and cannot be changed.
root
Login Port
Number of the port for remotely logging in to the server. The default value is 22. To change the remote login port, see How Can I Change a Remote Login Port?
22
Authentication
Authentication mode for logging in to the server. You can select Password or SSH key.
SSH key
Password/SSH Key
Enter the password or SSH key for logging in to the server.
Example key:
-----BEGIN RSA PRIVATE KEY-----
******
-----END RSA PRIVATE KEY-----
Operation
Operations on server configurations. You can delete or copy the information.
Copy
- Select an Agent edition.
- After the configuration is complete, click OK.
- Check the Agent installation results.
- In the navigation pane, choose Task Center.
- In the right pane, click the Agent Maintenance tab to view the task status.
- If Status is Successful, the Agent is installed. On the Server Monitoring page, check that the Agent status is Running and the Agent version is the latest.
- If Status is Timeout, click Retry in the Operation column.
In the given VPC, you can log in to the server with the Agent installed and run the batch installation command to install the Agents.
- Log in to the Cloud Eye console.
- In the navigation pane, choose Server Monitoring > Elastic Cloud Server.
- Click Install Manually above the server list. The installation guide is displayed on the right.
- Obtain the installation command.
- Select Linux.
- Select Batch Installation.
- Click
next to the installation command to copy the command.
Figure 5 Obtaining the batch Agent installation command
- Log in to the ECS with the Agent installed as user root.
For details, see Login Overview (Linux).
- After the login is successful, upload prepared files based on the login mode.
- Username and password: As you have collected IP addresses of all ECSs and the password of user root, keep them in the iplist.txt file and upload them to the /usr/local directory on the first ECS.
In the iplist.txt file, each line contains only one IP address in the IP address,Password of user root format.
In the following example, abcd is the password.
192.168.1.1,abcd 192.168.1.2,abcd
- Key: As you have collected IP addresses of all ECSs, keep them in the iplist.txt file, upload them to the /usr/local directory on the first ECS, and uploaded the key file user.pem to the /usr/local directory on the ECS.
In the iplist.txt file, each line contains only one IP address.
Example:
192.168.1.1 192.168.1.2
- Username and password: As you have collected IP addresses of all ECSs and the password of user root, keep them in the iplist.txt file and upload them to the /usr/local directory on the first ECS.
- Run the command obtained in 4 to install the Agents in batches.
- Check the Agent installation results.
If the message "Telescope process starts successfully." is displayed, the installation is successful. Wait for 3 to 5 minutes, the Agent starts collecting monitoring data.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot