Docs
umon
HowTos
agent

Monitoring Agent

The monitoring agent is an auxiliary agent program independently developed and open-sourced by the platform. Installing the monitoring agent in the cloud host or physical cloud host can enable resources to work better with the cloud platform monitoring system, thereby expanding the monitoring depth of resources and enriching monitoring indicators (such as memory, disk space, processes, etc.).

1.Version Description

Update TimeAgent VersionUpdate Content DescriptionNote
2023.08.15v1.2.3Added support for adapting Rocky 8.5 64-bit, Rocky 9.1 64-bit, Ubuntu 22.04 64-bit, Ubuntu 20.04 64-bit, Ubuntu 18.04 64-bit, high kernel Ubuntu 18.04 64-bit
2023.06.20v1.2.2Added support for physical cloud host /dev/nvme monitoring on Python3
2022.12.07v1.2.1Added uma collection supports diskpart usage rate monitoring
2022.09.05v1.2.0Optimize the logic of uma collection memory usage
2022.08.15v1.1.9Added multi-disk monitoring function for physical machines
2022.07.30v1.1.8After adding, uma will automatically start upon installation.
2022.01.25v1.1.7Added the number of ECC errors in the memory of the physical cloud host and the number of disk abnormalities (ro), supporting CentOS and Ubuntu operating systems.The ECC memory error count feature is only supported on Python2.
2021.03.08v1.1.6Added support for BareMetal 2.0 version
2019.08.12v1.1.5Fixed the issue of being unable to use when the kernel version is higher than 4.18
2018.01.03v1.1.4Fix the bug that may generate zombie processes
2017.10.31v1.1.3Added support for physical cloud collection of GPU temperature
2017.05.15v1.1.2Optimize Agent Collection Method
2017.03.07v1.1.1Added a health status check for the physical cloud host disk (0 indicates normal, 1 indicates abnormal), supporting CentOS and Ubuntu operating systems.
2016.03.25v1.0.2Optimize TCP connection collection for Linux version
2016.01.07v1.0.1Fix the bug where data collection errors are caused by excessively long disk names.

Comment

  1. If you need to use the Linux intranet data reporting version, please reinstall the agent; umagent now supports physical cloud hosts. If there is an error after installation, please resolve the dependency according to the error message.
  2. The monitoring agent only supports kernel versions below 4.18. Using kernels 4.18 and above in conjunction with UMA may result in the inability to obtain some indicators.

2.Preparation for Monitoring Agent Installation

  • The installation process requires the use of system administrator users (such as root, administrator, etc.).
  • The installation process needs to be carried out in the internal network environment of UCloud UHost.

3.Red Hat/CentOS

Comment: Install the uma installation package for py2 or py3 according to the default python version of the current system. If the installation fails, you can try to install the other version.

3.1.1 Python2 version UMA installation

64-bit Operating System:

wget http://umon.api.service.ucloud.cn/static/umatest/uma-1.2.3-1.x86_64.rpm
rpm -ivh uma-1.2.3-1.x86_64.rpm

32-bit Operating System:

wget http://umon.api.service.ucloud.cn/static/umatest/uma-1.2.3-1.i386.rpm
rpm -ivh uma-1.2.3-1.i386.rpm

3.1.2 Python3 version UMA installation

664-bit Operating System:

wget http://umon.api.service.ucloud.cn/static/umatest/uma-py3-1.2.3-1.x86_64.rpm
rpm -ivh uma-py3-1.2.3-1.x86_64.rpm

3.2 Start

service uma start

3.3 Stop

service uma stop

3.4.1 Uninstalling uma version python2

rpm -e uma

3.4.2 Uninstallation of python3 version uma

rpm -e uma-py3

4. Ubuntu/Debian

Note: Depending on the current system's default Python version, install the Py2 or Py3 version of the UMA package. If the installation fails, you can try installing the other version.

4.1.1 Python2 version UMA installation

64-bit Operating System:

wget http://umon.api.service.ucloud.cn/static/umatest/uma_1.2.3-1_amd64.deb
dpkg -i uma_1.2.3-1_amd64.deb

32-bit Operating System:

wget http://umon.api.service.ucloud.cn/static/umatest/uma_1.2.3-1_i386.deb
dpkg -i uma_1.2.3-1_i386.deb

4.1.2 Python3 version of UMA installation

64-bit Operating System:

wget http://umon.api.service.ucloud.cn/static/umatest/uma-py3_1.2.3-1_amd64.deb
dpkg -i uma-py3_1.2.3-1_amd64.deb

4.2 Start

service uma start

4.3 Stop

service uma stop

4.4.1 Uninstalling uma version python2

dpkg -P uma

4.4.2 Uninstalling uma version of python3

dpkg -P uma-py3

5. Dependency Package for Physical Cloud Disk Status Monitoring

The current agent version has added a metric for checking the health status of the physical cloud host disk. This metric only returns 0 and 1, where 0 indicates that the disk is healthy, otherwise it returns 1.

Installation dependencies: Dependencies: 1. smartmontools 2. MegaCli64 3. dmidecode 4. hpssacli