Help Center/ Application Operations Management/ User Guide/ (New) Connecting to AOM/ Managing Collector Base UniAgent/ Managing ICAgent Plug-ins for Hosts
Updated on 2026-07-29 GMT+08:00
View PDF
Share

Managing ICAgent Plug-ins for Hosts

AOM will support interconnection with other types of plug-ins. You can install, upgrade, uninstall, start, stop, and restart plug-ins in batches for hosts.

Currently, only ICAgents are supported. An ICAgent is a plug-in for collecting metrics and logs. ICAgent collects data at an interval of 1 minute. This interval cannot be changed.

Managing ICAgent Plug-ins in Batches

  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 on the left, choose Collection Settings > UniAgents. The old VM access page is displayed. You can click Try New Version in the upper right corner to go to the new UniAgent management page.
  4. Select one or more target servers and click Plug-in Batch Operation.
  5. In the displayed dialog box, select an operation type, set the plug-in information, and click OK. (When selecting a CCE host, you are advised to go to the K8s Clusters page to operate the ICAgent.)

    Table 1 Plug-in operation parameters

    Parameter

    Description

    Operation

    The following batch operations are supported: install, upgrade, uninstall, start, stop, and restart.

    If the ICAgent is uninstalled from a server, AOM will not collect metrics from the server. Exercise caution when performing this operation.

    • During plug-in batch operation, if a host runs on Windows, ensure that UniAgent 1.1.9 or later has been installed on that host.
    • If an ICAgent has a new version, Upgradeable will be displayed in the Plug-ins Installed column on the UniAgents page. You can upgrade the ICAgent as required. (If the ICAgent installed on the host in a CCE cluster has a new version, Upgradable will only be displayed on the K8s Clusters page. You can upgrade the ICAgent on that page by referring to Managing UniAgents and ICAgents in K8s Clusters.)

    Plug-in

    Select the plug-in to be operated. The ICAgent of the latest version can be installed. For details about ICAgent version description, see Table 2.

    AK/SK

    Access Key ID/Secret Access Key (AK/SK) to be entered based on your plug-in type and version. For details, see How Do I Obtain an AK/SK.

    You need to enter an AK/SK only when installing the ICAgent of an earlier version. (If there is no text box for you to enter the AK/SK, the ICAgent of the new version has already been installed.)
    Table 2 ICAgent version description

    Version

    Description

    Released

    7.8.2

    Fixed the issue that the collection path contains special wildcard characters.

    2026-06-11

    7.8.1
    • Added cursor restrictions.
    • Supported access code authentication for self-built K8s clusters.
    • Supported custom delimiters for structured data collection.

    2026-05-30

    7.7.1
    • Supported mounting of the DockerRoot directory to self-built K8s clusters and batch installation using agencies.
    • Optimized log collection from containers.

    2026-04-01

    7.6.8

    Optimized the log printing function.

    2026-03-23

    7.6.2

    Fixed the issue that container standard output logs are occasionally not collected or re-collected.

    2026-01-26

    7.6.1
    • Increased the maximum JSON parsing depth to 10 layers for structuring configurations.
    • Optimized memory usage in ICAgent-based log collection scenarios.
    • Introduced resource restrictions for nodes with 1 vCPU and 2 GB memory.

    2025-12-25

    7.5.10

    Optimized the logic for ICAgent to search for wrapped files.

    2025-12-22

    7.5.9
    • Fixed an issue where CPU metrics were not displayed in AOM host monitoring when IPv6 was enabled.
    • Fixed an issue where excessive inactive files caused high ICAgent memory usage.

    2025-12-09

    7.5.8

    Optimized memory allocation for ICAgent during error diagnosis log collection.

    2025-11-27

    7.5.6
    • Changed the maximum number of ECS and container log files that can be collected to 1,000.
    • Corrected disordered context logs caused by low log time precision during standard output (stdout) collection.

    2025-11-20

    7.5.5
    • Optimized the logic for ICAgent to report host information.

    2025-11-04

    7.5.1
    • Switched the ICAgent base image to HCE 2.0 for installing ICAgent in container scenarios.
    • Added the stream field to the standard output log collection.
    • Optimized the logic for collecting system logs.
    • Removed the ICAgent function of collecting logs to APM 1.0.

    2025-10-22

    7.4.3
    • Optimized the command for installing ICAgent on self-built Kubernetes clusters.
    • Supported the extraction of specified keys in JSON format for the combination parsing scenario.
    • Supported CCE clusters of v1.33.

    2025-09-11

    7.3.7
    • Resolved an issue where the log filtering rule did not take effect during multi-line full-text log collection.
    • Adjusted the priority of host NPU metric collection.
    • Optimized the logic for adding container log collection tasks.

    2025-08-14

    7.3.6
    • Optimized the logic for collecting standard output.
    • Optimized the ICAgent installation script for ECSs.
    • Optimized the logic for ICAgent to generate AgentId.
    • Resolved an issue in standard output collection tasks where the last line of a log file was not reported when a multi-line configuration was used.

    2025-07-25

    7.3.3
    • Optimized the regular expression verification logic for container log collection.
    • Fixed the issue where container logs failed to collect when the collection path is set to the mount directory's parent.

    2025-06-26

    7.3.2

    Resolved the issue where ICAgent-reported system logs cannot be queried by cluster name on the AOM 1.0 console in self-built Kubernetes scenarios.

    2025-06-09

    7.3.1
    • Introduced an option to select logical relationships for whitelist log filtering in ICAgent structuring.
    • Added support for Base64 encoding and decoding for ICAgent log collection and reporting.
    • Added support for ECS OpenStack API V2 for ICAgent.
    • Enhanced container log and standard output collection in self-built Kubernetes to function even if port 10255 is not enabled.

    2025-05-26

    7.2.6

    Improved the AgentId file clearance logic for ICAgent re-installation and uninstallation on ECSs, resolving the issue of AgentId duplication after ICAgent is pre-installed in private images.

    2025-05-14

    7.2.4

    Adjusted the cursor directory structure. Cursor file names no longer include log group or log stream paths, and cursor files now stored directly in their corresponding directories.

    2025-04-25

    7.2.2
    • Resolved intermittent standard output collection failures caused by occasional blocking of the collection coroutine during high log volume.
    • Solved the issue where the reason field is not reported when Kubernetes events are reported.

    2025-03-13

    7.2.1
    • Added line number processing to the structured single-line regular expression and multi-line regular expression.
    • Optimized the logic for obtaining labels during log sending.
    • Supported the configuration of multiple NTP servers for NTP metrics.
    • Added the function of collecting container NPU metrics by using pod IP addresses.

    2025-02-28

    7.1.22

    Optimized the code to reduce the memory consumed for obtaining pod information.

    2025-01-23

    7.1.19
    • Optimized the logic for generating agent IDs.
    • Changed the expiration time of wrapped files to 2 hours.
    • Optimized the log printing function.

    2025-01-13

    7.1.17

    Optimized the log collection process to adjust the size of transmitted blocks.

    2025-01-03

    7.1.14
    • Optimized the log collection process.
    • Updated to persistently save signature information during log collection.

    2024-12-25

    7.1.12

    Solved the issue where, in some scenarios, CPU usage increased due to timer leakage caused by the Go version.

    2024-12-15

    7.1.6
    • Enabled logs to report image names.
    • Optimized the log collection process.
    • Upgraded ICAgent's base image version.

    2024-11-21

    7.1.5

    Solved the issue that logs continued to be collected after all configurations in a project are deleted or disabled.

    2024-11-21

    7.1.3

    Optimized the httpclient component's performance in log sending.

    2024-11-02

    7.1.1

    Optimized the ICAgent architecture and unified the Agents of AOM 1.0 and AOM 2.0.

    2024-10-26

    5.12.233
    • Optimized the structuring performance for container logs.
    • Solved the issue that error diagnosis occasionally failed to be reported in CCE scenarios.
    • Solved the issue that inactive files failed to be collected in VM scenarios.

    2024-10-17

    5.12.232
    • Replaced the JSON library used for parsing standard output logs with the sonic library to reduce the CPU usage.
    • Solved the issue of log transmission timeouts when using LTS.

    2024-10-14

    5.12.231
    • Solved the issue that ICAgent restarted under the following conditions: Standard output was collected by LTS; there were no log ingestion rules defined in LTS; and a container was created in CCE and standard output logs were printed.
    • Solved the issue where hisfile in the cursor file was incorrectly recognized as a directory.
    • Solved the issue where the incremental collection switch was ineffective.

    2024-10-11

    5.12.230
    • Solved the issue where periodic cursor refresh was not functioning.
    • Solved the issue where the cursor could not be reset after the base file was wrapped since the wrapping file could not be found.
    • Solved the issue of high CPU usage caused by file signature.

    2024-10-09

    5.12.224

    Cleared all export HISTSIZE=0 entries (if any) from the .bashrc file in the ECS upgrade scenario.

    2024-09-27

    5.12.218
    • Supported GBK encoding in the logs reported by ICAgent.
    • Enabled ICAgent to collect the same log files repeatedly.

    2024-09-26

    5.12.185
    • Fixed the invalid blacklist path in the VM log configuration.
    • Optimized the collection of containerd standard output logs.

    2024-05-20

    5.12.184
    • Solved the issue of being unable to exclude wrapped files when container logs were collected.
    • Changed the number of concurrent collection coroutines of node log collection to 32.

    2024-05-16

    5.12.183

    Optimized the wrapping files for the container standard output of containerd nodes.

    2024-05-11

    5.12.182

    Solved the syslog switch issue.

    2024-04-28

    5.12.181
    • Solved the ICAgent authentication failure on self-built Kubernetes clusters.
    • Solved the log truncation issue.
    • Solved the issue that some files were not collected because wrapped files could not be found when the log rate was high.

    2024-04-25

    5.12.177

    Solved the infinite loop issue of wrapping.

    2024-03-28

    5.12.176
    • Optimized .zip streaming parsing: Check whether transferred files are complete.
    • Specified the maximum number of connections to each PodLB host.

    2024-03-18

    5.12.175

    Solved the collection performance bottleneck issue of structured logs.

    2024-03-13

    5.12.172

    Optimized the supported wrapping mode.

    2024-02-28

    5.12.171

    Solved the JSON parsing issue (not deleting escape characters) of standard output logs of Docker nodes.

    2024-01-31

    5.12.170
    • Supported incremental collection of host, container, and standard output logs.
    • Resolved the host GPU metric disconnection issue.

    2024-01-29

    5.12.166
    • Solved the high memory usage issue of the standard output log collection plug-in.
    • Solved the issue that the VM log collection plug-in repeatedly collected wrapped files.
    • Added the log group and log stream information to the cursor files.

    2023-12-27

    5.12.165

    Added the function of obtaining the initial agent ID from the configuration file. If the agent ID does not meet the verification requirements, the randomly generated UUID is used.

    2023-12-21

    5.12.163

    Supported ICAgent installation using the UniAgent plug-in.

    2023-12-13

    5.12.159
    • Solved the leakage issue of the standard output log collection coroutine.
    • Solved the issue that standard output wrapping logs could not be collected after standard output logs were collected to AOM.

    2023-11-27

    5.12.158

    Solved the issue that memory leakage of container metrics caused ICAgent restart when the metric switch was turned off.

    2023-11-08

    5.12.157
    • Container log ingestion to LTS: supported Docker driver Device Mapper.
    • Solved the issue that ICAgent restarted due to too many VM logs (fast transferring) and sharp increase of memory usage.

    2023-11-06

    5.12.156

    Solved the issue of obtaining the installation package from OBS and changed the protocol from HTTP to HTTPS.

    2023-11-01

    5.12.154

    Supported log structuring.

    2023-10-31

    5.12.150
    • Resolved the cluster name and ID not-set issues.
    • Supported CCE clusters of v1.27.

    2023-10-17

    5.12.149

    Supported mounting wrapping.

    2023-10-12

    5.12.148

    Solved the high CPU usage issue in the multi-GPU scenario.

    2023-08-30

    5.12.147

    Solved the issue that log transfer function could not be restarted and the host GPU metric adaptation issue.

    2023-08-17

    5.12.142

    Supported the collection of container GPU metrics of CCE clusters of v1.25 or later.

    2023-06-13

    5.12.139

    Solved the issue of a large number of TIME_WAIT TCP connections when LTS logs are reported.

    2023-04-25

    5.12.135
    • Solved the 0% CPU usage issue.
    • Solved the missing container network metrics of containerd nodes in CCE v1.23 clusters.
    • Supported collection of disk partition metrics of EulerOS 2.5.

    2023-02-08

    5.12.133

    Supported multi-line collection of container standard output logs.

    2022-12-17

    5.12.130

    Supported direct ingestion of CCE logs to LTS.

    2022-11-04

    5.12.120
    • Added a metric: maximum number of process handles.
    • Supported changing of the LTS PodLB domain name.

    2022-08-28

    5.12.111

    Added thread metrics and fixed the issue that the LVS disk partition metrics fail to be obtained.

    2022-06-09

    5.12.100
    • Added two metrics: used memory working set and memory working set usage.
    • Supported container log tagging with stderr.log or stdout.log during collection.
    • Added the Pod_ip tag for container log reporting.
    • Supported double asterisks (**) for matching files in the current directory.

    2022-01-15

    5.12.98

    Supported LTS log collection blacklists and changed the source of container metrics to working_set.

    2021-09-29

    5.12.96

    Supported discovery of more types of cloud resources.

    2021-09-22

    5.12.90

    Updated the GPU metric source.

    2021-07-15

    5.12.87

    Supported more types of disks.

    2021-03-30

    5.12.75

    Adapted to secure containers.

    2021-03-09

Parent Topic: Managing Collector Base UniAgent