# 主机场景管理ICAgent LTS支持通过ICAgent插件采集上报日志。ICAgent是云日志服务进行日志采集的工具，运行在需要采集日志的主机中。本文介绍如何在目标服务器中安装ICAgent、升级ICAgent、卸载ICAgent、查看ICAgent状态、查看ICAgent版本说明。 主机场景适用于物理服务器、云服务器ECS等传统计算环境。根据主机所在位置分为区域内主机和区域外主机。 #### 安装ICAgent 根据主机所在位置分为区域内主机和区域外主机，详细操作请参考[安装ICAgent（区域内主机）](https://support.huaweicloud.com/usermanual-lts/lts_02_0013.html)和[安装ICAgent（区域外主机）](https://support.huaweicloud.com/usermanual-lts/lts_02_0828.html)。 #### 升级ICAgent LTS会自动检测主机安装的ICAgent插件版本。如果检测到您的主机中后期不维护的ICAgent插件版本时，当您进入LTS控制台后，界面会弹出"ICAgent版本太低"的提示框。关于ICAgent采集插件版本的维护情况请参考[服务公告](https://www.huaweicloud.com/notice/2025/20250627163836749.html)。 - 您可以单击"**授权自动升级**"授权LTS为您在业务低峰期自动升级ICAgent插件。 - 如果您不想要自动升级ICAgent插件，也可以单击"**前往手动升级**"参考如下操作步骤，前往主机管理页面升级ICAgent。 - 如果您**暂不需要升级ICAgent插件**，可勾选"下次不再提示"前的复选框，取消提示信息。 - 升级ICAgent不会影响您的业务运行，建议在业务低峰期进行升级。 - 升级过程中，ICAgent上报的监控指标会出现2-3min左右的断点。 - 升级ICAgent不会影响日志采集，升级完成后，ICAgent会从升级前采集的位置继续采集日志。 如果需要升级Windows环境中的ICAgent，请先卸载旧版本ICAgent，再安装新版本ICAgent即可。 1. 登录管理控制台，选择"管理与部署 \> 云日志服务 LTS"，进入"日志管理"页面。 2. 左侧导航栏选择"主机管理 \> 主机"，进入"主机"页面。 3. 选择"区域内主机"或"区域外主机"，当系统提示您有新的ICAgent版本时，在主机列表中选中一个或多个待升级ICAgent前的复选框，单击"升级ICAgent"。 4. 在"升级ICAgent"对话框中，单击"确定"开始升级ICAgent。 升级ICAgent预计需要1分钟左右，请耐心等待。待ICAgent的状态由"升级中"变为"运行"时，表示升级成功。 如果升级后，界面显示ICAgent状态异常或者其他升级失败场景，请直接登录节点使用安装命令重新安装ICAgent即可（覆盖式安装，无需卸载操作）。详细操作请参考[安装ICAgent（区域内主机）](https://support.huaweicloud.com/usermanual-lts/lts_02_0013.html)和[安装ICAgent（区域外主机）](https://support.huaweicloud.com/usermanual-lts/lts_02_0828.html) #### 卸载ICAgent ![](https://support.huaweicloud.com/usermanual-lts/public_sys-resources/warning_3.0-zh-cn.png) 服务器上的ICAgent被卸载后，会影响该服务器的日志采集能力，请谨慎操作！ 卸载ICAgent不会删除对应的安装文件，请您根据实际情况自行删除。 云日志服务主机管理界面，仅支持卸载安装在Linux环境中的ICAgent，如果需要卸载安装Windows环境中的ICAgent，请在ICAgent安装包解压目录下，双击执行"*ICAgent安装包解压目录*\\ICProbeAgent\\bin\\manual\\win\\uninstall.bat"脚本，当显示"ICAgent uninstall success"时，表示卸载成功。 卸载方式，您可以按照需要进行选择：（以下提供的都是Linux系统的卸载方式） - **通过界面卸载** ：此操作适用于正常安装ICAgent后需卸载的场景。 1. 左侧导航栏选择"主机管理 \> 主机"，进入"主机"页面。 2. 勾选一个或多个待卸载ICAgent的服务器的复选框，单击"卸载ICAgent"。 3. 在"卸载ICAgent"对话框中单击"确定"。 ICAgent开始卸载，卸载ICAgent预计需要1分钟左右，请耐心等待。 卸载完成后在主机列表中ICAgent状态显示"未安装"。 通过界面卸载ICAgent后如果需要再次安装，请等待5分钟后执行安装操作，否则可能出现被再次自动卸载的情况。 - **登录服务器卸载** ：此操作适用于未成功安装ICAgent需卸载重装的场景。 1. 以**root**用户登录需卸载ICAgent的服务器。 2. 执行如下命令卸载ICAgent。 ``` bash /opt/oss/servicemgr/ICAgent/bin/manual/uninstall.sh ``` 当显示"ICAgent uninstall success"时，表示卸载成功。 - **远程卸载** ：此操作适用于正常安装ICAgent后需远程卸载的场景。 除了上述登录服务器上执行uninstall.sh命令卸载ICAgent的方式，还可以对服务器进行远程卸载。远程卸载的服务器需同属一个VPC下，并在同一个网段中**。** 1. 在已安装ICAgent的服务器上执行如下命令，其中*x.x.x.x* 表示待卸载ICAgent的服务器的IP地址。 ``` bash /opt/oss/servicemgr/ICAgent/bin/remoteUninstall/remote_uninstall.sh -ip x.x.x.x ``` 2. 根据提示输入待卸载ICAgent的服务器root用户密码。 - 如果已安装ICAgent的服务器安装过expect工具，执行上述命令后，即可完成卸载。如果已安装ICAgent的服务器未安装expect工具，请根据提示输入密码，进行卸载。 - 请确保已安装ICAgent的服务器可以使用root用户执行SSH、SCP命令，来与待卸载ICAgent的服务器进行远端通信。 - 当显示"Uninstall ICAgent success"时，表示卸载成功。 - **批量卸载** ：此操作适用于正常安装ICAgent后需批量卸载的场景。 当您已有服务器安装过ICAgent，且该服务器"/opt/ICAgent/"路径下存在ICAgent安装包**ICProbeAgent.tar.gz**，通过该方式可对多个服务器进行一键式继承批量卸载。 ![](https://support.huaweicloud.com/usermanual-lts/public_sys-resources/caution_3.0-zh-cn.png) 批量卸载的服务器需同属一个VPC下，并在同一个网段中。 **前提条件** 已收集需要卸载ICAgent的所有服务器的IP地址、密码，按照iplist.cfg格式整理好，并上传到已安装过ICAgent机器的/opt/ICAgent/目录下。**iplist.cfg格式示例如下，IP地址与密码之间用空格隔开**： ``` 192.168.0.109 密码（请根据实际填写） 192.168.0.39 密码（请根据实际填写） ``` - iplist.cfg中包含您的敏感信息，建议您使用完之后进行清理。 - 如果所有服务器的密码一致，iplist.cfg中只需列出IP地址，无需填写密码，在执行时输入此密码即可；如果某个IP密码与其他不一致，则需在此IP地址后填写其密码。 **操作步骤** 1. 在已安装ICAgent的服务器上执行如下命令。 ``` bash /opt/oss/servicemgr/ICAgent/bin/remoteUninstall/remote_uninstall.sh -batchModeConfig /opt/ICAgent/iplist.cfg ``` 根据脚本提示输入待卸载机器的root用户默认密码，如果所有IP地址的密码在iplist.cfg中已有配置，则直接输入回车键跳过即可，否则请输入默认密码。 请耐心等待，当提示**Uninstall ICAgent success**时，则表示配置文件中所有服务器的卸载操作已完成。 但是用来执行卸载操作的服务器上的ICAgent不会被卸载，您需要单独卸载该服务器的ICAgent。 2. 卸载完成后，在云日志服务左侧导航栏中选择"主机管理 \> 主机"，查看该服务器的ICAgent状态。 #### 查看ICAgent状态 左侧导航栏选择"主机管理 \> 主机"，根据主机所在位置选择"区域内主机"或"区域外主机"页签，查看目标主机的ICAgent状态。详细请参见[表1]和[表2]。 表1Windows主机的ICAgent版本说明 | 版本号 | 说明 | 发布时间 | |:---|:---|:---| | 5.26.1 | - 云主机ECS文本日志接入LTS支持重复采集。 - 云主机ECS文本日志接入LTS支持添加自定义绕接规则。 | 2026-06-25 | 表2Linux主机的ICAgent状态 | 状态 | 说明 | |:---|:---| | 运行 | 该服务器的ICAgent运行正常。 | | 未安装 | 出现网络异常或者主机关机等原因，则会导致ICAgent超过一周没有上报心跳给ICAgent管理端。 | | 安装中 | 正在为该主机安装ICAgent。安装ICAgent预计需要1分钟左右，请耐心等待。 | | 安装失败 | 该主机的ICAgent安装失败。 | | 升级中 | 正在升级该服务器的ICAgent。升级ICAgent预计需要1分钟左右，请耐心等待。 | | 升级失败 | 该服务器的ICAgent升级失败。 | | 离线 | 输入的AK/SK错误导致该主机的ICAgent功能异常。请获取正确的AK/SK后重新安装。 出现网络异常或者主机关机等原因，则会导致ICAgent在超过10min没有上报心跳给ICAgent管理端。 | | 异常 | 该主机ICAgent功能异常，请联系技术支持。 | | 卸载中 | 正在卸载该主机。卸载ICAgent预计需要1分钟左右，请耐心等待。 | | 鉴权错误 | 安装该主机时配置的参数问题导致无法正常鉴权。 | #### 查看ICAgent版本说明 左侧导航栏选择"主机管理 \> 主机"，根据主机所在位置选择"区域内主机"或"区域外主机"页签，查看目标主机的ICAgent版本，建议您尽快升级到最新版本。详细请参见[表3]。 表3ICAgent版本说明 | 版本号 | 说明 | 发布时间 | |:---|:---|:---| | 7.9.1 | - 日志采集开启结构化解析时，支持自定义标签前缀。 - 自建K8s场景下，不支持从apiserver接口获取pod信息。 - 支持采集最短存活10s的容器标准输出日志。 - 支持集群维度限流。 | 2026-07-31 | | 7.8.2 | 修复日志采集时，采集路径含特殊通配符的问题。 | 2026-06-11 | | 7.8.1 | - 新增游标限制。 - 支持自建K8s AccessCode鉴权。 - 支持结构化采集自定义多分隔符。 | 2026-05-30 | | 7.7.1 | - 支持自建K8s挂载DockerRoot目录，委托批量安装。 - 优化容器采集日志。 | 2026-04-01 | | 7.6.8 | 优化日志打印。 | 2026-03-23 | | 7.6.2 | 修复采集容器标准输出偶现的漏采、重采问题。 | 2026-01-26 | | 7.6.1 | - 结构化配置时，JSON解析层数最大支持10层。 - ICAgent采集日志场景下的内存优化。 - 增加关于1U2G节点的资源限制。 | 2025-12-25 | | 7.5.10 | 优化ICAgent查找绕接文件的逻辑。 | 2025-12-22 | | 7.5.9 | - 解决IPv6开启场景下，AOM主机监控CPU指标无法展示的问题。 - 解决不活跃文件过多导致ICAgent内存占用高的问题。 | 2025-12-09 | | 7.5.8 | 优化ICAgent错误诊断日志采集时的内存分配。 | 2025-11-27 | | 7.5.6 | - ECS和容器日志采集文件上限调整为1000。 - 解决标准输出采集时日志时间精度不够导致的查看上下文日志错乱的问题。 | 2025-11-20 | | 7.5.5 | - 优化ICAgent上报主机信息的逻辑。 | 2025-11-04 | | 7.5.1 | - 容器部署场景ICAgent基础镜像切换为HCE2.0。 - 标准输出日志采集增加stream字段。 - 优化采集系统日志的逻辑。 - ICAgent下线APM1.0功能。 | 2025-10-22 | | 7.4.3 | - 优化自建k8s安装命令。 - 组合解析场景下，支持json结构化提取指定的key。 - 支持CCE集群1.33版本。 | 2025-09-11 | | 7.3.7 | - 解决多行全文日志采集，日志过滤规则不生效的问题。 - 调整主机NPU指标优先级。 - 优化容器日志采集任务添加的逻辑。 | 2025-08-14 | | 7.3.6 | - 优化标准输出采集逻辑。 - 优化ECS安装ICAgent的安装脚本。 - 优化ICAgent生成AgentId的逻辑。 - 解决标准输出采集任务配置多行时，文件最后一行日志不上报的问题。 | 2025-07-25 | | 7.3.3 | - 优化容器日志采集正则校验的逻辑。 - 解决容器日志采集路径配置为挂载目录上级时无法采集的问题。 | 2025-06-26 | | 7.3.2 | 解决在自建k8s场景下无法在AOM1.0页面通过集群名称查找ICAgent上报系统日志的问题。 | 2025-06-09 | | 7.3.1 | - LTS配置ICAgent结构化日志过滤的白名单里支持逻辑关系选择。 - ICAgent采集上报支持base64编解码。 - ICAgent调用ECS openstack支持V2版本接口 - 自建k8s没有开启10255端口时，容器日志和标准输出日志也支持采集。 | 2025-05-26 | | 7.2.6 | ECS重装或卸载ICAgent时，优化清理AgentId文件的逻辑，解决私有镜像预置ICAgent后导致的AgentId重复问题。 | 2025-05-14 | | 7.2.4 | 调整游标目录：游标文件名取消日志组日志流，同时将游标文件放入到日志组日志流组成的目录中。 | 2025-04-25 | | 7.2.2 | - 解决大量日志采集场景下，采集协程偶现阻塞导致ICAgent不采集标准输出日志的问题。 - 解决上报k8s事件时reason字段未上报的问题。 | 2025-03-13 | | 7.2.1 | - 结构化单行正则以及多行正则增加行号处理。 - 优化日志发送时label的获取逻辑。 - ntp指标支持配置多台ntp服务器。 - 适配容器npu指标采集，使用podIP进行指标获取。 | 2025-02-28 | | 7.1.22 | 优化代码，减少获取pod信息时内存消耗。 | 2025-01-23 | | 7.1.19 | - 优化AgentId生成逻辑。 - 修改绕接文件过期时间为2小时。 - 优化日志打印。 | 2025-01-13 | | 7.1.17 | 优化日志采集流程，调整发送块大小。 | 2025-01-03 | | 7.1.14 | - 优化日志采集流程。 - 日志采集时，持久化保存签名信息。 | 2024-12-25 | | 7.1.12 | 解决在某些场景下，Go版本引起的定时器泄漏导致CPU升高的问题。 | 2024-12-15 | | 7.1.6 | - 支持日志上报镜像名称。 - 优化采集日志流程。 - 升级ICAgent基础镜像版本。 | 2024-11-21 | | 7.1.5 | 解决用户project下所有配置删除或关闭后，仍然继续采集日志的问题。 | 2024-11-21 | | 7.1.3 | 优化发送日志时httpclient组件性能。 | 2024-11-02 | | 7.1.1 | 优化ICAgent架构，统一AOM1.0和AOM2.0的Agent。 | 2024-10-26 | | 5.12.233 | - 优化容器日志结构化性能。 - 解决CCE场景错误诊断偶现上报失败的问题。 - 解决虚机场景不活跃文件采集失效的问题。 | 2024-10-17 | | 5.12.232 | - 解析标准输出日志用到的json库替换为sonic，降低CPU使用率。 - LTS发送日志出现超时，解决超时问题。 | 2024-10-14 | | 5.12.231 | - 解决以下条件满足的情况下ICAgent重启的问题：标准输出采集到LTS、LTS不配置日志接入规则、CCE创建新容器并打印标准输出日志。 - 解决游标文件中hisfile变成目录的问题。 - 解决增量采集开关不生效的问题。 | 2024-10-11 | | 5.12.230 | - 解决游标定时刷新功能不生效的问题。 - 查找不到绕接文件的情况下，解决base文件绕接后无法重置游标的问题。 - 解决文件签名导致cpu高的问题。 | 2024-10-09 | | 5.12.224 | 在ECS升级场景下，若".bashrc文件中export HISTSIZE=0"大于1条，则清除".bashrc文件中的export HISTSIZE=0"。 | 2024-09-27 | | 5.12.218 | - ICAgent上报日志支持GBK编码。 - ICAgent上报日志允许文件多次采集。 | 2024-09-26 | | 5.12.185 | - 解决虚机日志配置中黑名单路径不生效问题。 - 优化containerd标准输出日志采集的问题。 | 2024-05-20 | | 5.12.184 | - 解决容器日志采集功能中无法排除绕接文件的问题。 - 节点日志采集功能并发采集协程调整为32个。 | 2024-05-16 | | 5.12.183 | 优化containerd节点采集容器标准输出绕接文件的问题。 | 2024-05-11 | | 5.12.182 | 解决syslog开关问题。 | 2024-04-28 | | 5.12.181 | - 解决自建k8s icagent认证失败问题。 - 解决日志截断问题。 - 解决日志速率很大的情况下，查找不到绕接文件导致文件漏采的问题。 | 2024-04-25 | | 5.12.177 | 解决绕接死循环问题。 | 2024-03-28 | | 5.12.176 | - zip流式解析优化：检查转储文件是否结束。 - 限制podlb每个主机最大连接数。 | 2024-03-18 | | 5.12.175 | 解决了结构化日志采集性能瓶颈问题。 | 2024-03-13 | | 5.12.172 | 优化支持的绕接方式。 | 2024-02-28 | | 5.12.171 | 解决Docker节点标准输出日志Json解析问题（没有去掉转义字符）。 | 2024-01-31 | | 5.12.170 | - 主机日志，容器日志，标准输出日志支持增量采集。 - 解决主机gpu指标挂断问题。 | 2024-01-29 | | 5.12.166 | - 解决标准输出日志采集插件占用内存高问题。 - 解决虚机日志采集插件重复采集绕接文件问题。 - 游标文件中添加日志组和日志流信息。 | 2023-12-27 | | 5.12.165 | 从配置文件获取初始agentID，如果不符合校验要求则使用随机生成的uuid。 | 2023-12-21 | | 5.12.163 | 支持UniAgent插件化安装ICAgent。 | 2023-12-13 | | 5.12.159 | - 解决标准输出日志采集协程泄露问题。 - 解决标准输出日志采集到AOM后，不支持采集标准输出绕接日志的问题。 | 2023-11-27 | | 5.12.158 | 解决关闭指标开关后容器指标内存泄露导致ICAgent重启的问题。 | 2023-11-08 | | 5.12.157 | - CCE接入LTS的容器日志采集：支持Docker驱动Devicemapper。 - 解决虚机日志量大（转储快）ICAgent内存暴涨导致重启问题。 | 2023-11-06 | | 5.12.156 | 解决从OBS拉取安装包问题，将http协议改成https。 | 2023-11-01 | | 5.12.154 | 支持结构化功能。 | 2023-10-31 | | 5.12.150 | - 解决集群name和集群id not-set问题。 - 支持CCE集群1.27版本。 | 2023-10-17 | | 5.12.149 | 支持挂载绕接功能。 | 2023-10-12 | | 5.12.148 | 修复gpu多卡场景，解决cpu高的问题。 | 2023-08-30 | | 5.12.147 | 修复日志转储无法重启、主机gpu指标适配。 | 2023-08-17 | | 5.12.142 | 支持CCE集群1.25及以上版本的容器gpu指标采集。 | 2023-06-13 | | 5.12.139 | 解决上报LTS日志出现大量TIME_WAIT状态的TCP连接问题。 | 2023-04-25 | | 5.12.135 | - 解决CPU使用率为0的问题。 - 解决CCE1.23版本集群containerd节点容器网络指标缺失问题。 - 支持采集EulerOS 2.5系统的磁盘分区指标。 | 2023-02-08 | | 5.12.133 | 容器的标准输出日志支持多行采集。 | 2022-12-17 | | 5.12.130 | 支持将CCE日志直接接入LTS。 | 2022-11-04 | | 5.12.120 | - 增加进程的最大句柄数指标。 - 支持LTS的podlb域名的切换能力。 | 2022-08-28 | | 5.12.111 | 新增线程指标、修复"获取lvs磁盘分区指标失败"问题。 | 2022-06-09 | | 5.12.100 | - 上报内存指标增加内存workingset使用量、内存workingset使用率。 - 容器采集支持通过标签区分stderr.log和stdout.log。 - 容器上报增加Pod_ip的tag。 - \*\*配置匹配当前目录文件。 | 2022-01-15 | | 5.12.98 | 增加LTS日志黑名单功能，更改容器指标来源为working_set。 | 2021-09-29 | | 5.12.96 | 新增云资源发现类型。 | 2021-09-22 | | 5.12.90 | 更新gpu指标来源。 | 2021-07-15 | | 5.12.87 | 新增磁盘支持类型。 | 2021-03-30 | | 5.12.75 | 适配安全容器场景。 | 2021-03-09 |