更新时间:2025-03-21 GMT+08:00

管理ICAgent

ICAgent安装成功后,支持升级ICAgent卸载ICAgent查看ICAgent状态

升级ICAgent

为了更好的采集体验,LTS会不断更新ICAgent版本。当系统提示您有新的ICAgent版本时,您可以按照如下操作步骤进行升级。

云日志服务仅支持升级安装在Linux环境中ICAgent,不支持升级Windows环境中的ICAgent。

  1. 登录管理控制台,选择“管理与部署 > 云日志服务 LTS”,进入“日志管理”页面。
  2. 左侧导航栏选择“主机管理 > 主机”,进入“主机”页面。
  3. 选择“区域内主机”或“区域外主机”,当系统提示您有新的ICAgent版本时,在主机列表中选中一个或多个待升级ICAgent前的复选框,单击“升级ICAgent”。
  4. 选择“CCE集群”,在搜索框中选择待升级ICAgent的集群,单击“升级ICAgent”。

    • 首次创建的CCE集群,默认集群下的主机已安装了ICAgent且上报日志到AOM,采集容器标准输出到AOM的开关处于开启状态;如需将日志上报至LTS则执行升级ICAgent操作时,关闭采集容器标准输出到AOM的开关。建议使用“接入日志 > 云服务接入 > 云容器引擎CCE”直接采集容器标准输出到LTS,不推荐采集到AOM。
    • CCE集群ID(ClusterID): 每个集群为固定的ID。
    • 升级ICAgent时,LTS将为您的CCE集群创建对应的日志组和主机组。且该日志组和主机组的名称为k8s-log-{ClusterID}。您可以创建接入配置(云服务接入>云容器引擎CCE)将当前CCE集群的日志接入到该日志组。
    • 当集群里的主机未安装ICAgent或ICAgent版本过低时,单击“升级ICAgent”操作,可对该集群里的所有主机安装ICAgent。

  5. 在“升级ICAgent”对话框中单击“确定”。

    ICAgent开始升级,升级ICAgent预计需要1分钟左右,请耐心等待。待ICAgent的状态由“升级中”变为“运行”时,表示升级成功。

    如果升级后,界面显示ICAgent状态异常或者其它升级失败场景,请直接登录节点使用安装命令重新安装ICAgent即可(覆盖式安装,无需卸载操作)。

卸载ICAgent

服务器上的ICAgent被卸载后,会影响该服务器的日志采集能力,请谨慎操作!

卸载ICAgent不会删除对应的安装文件,请您根据实际情况自行删除。

卸载方式,您可以按照需要进行选择:

  • 通过界面卸载:此操作适用于正常安装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的方式,还可以对服务器进行远程卸载。

    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的服务器进行远端通信。
      • 当显示“ICAgent uninstall success”时,表示卸载成功。
  • 批量卸载:此操作适用于正常安装ICAgent后需批量卸载的场景。

    当您已有服务器安装过ICAgent,且该服务器“/opt/ICAgent/”路径下存在ICAgent安装包ICProbeAgent.tar.gz,通过该方式可对多个服务器进行一键式继承批量卸载。

    批量卸载的服务器需同属一个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中已有配置,则直接输入回车键跳过即可,否则请输入默认密码。

      batch uninstall begin
      Please input default passwd:
      send cmd to 192.168.0.109
      send cmd to 192.168.0.39
      2 tasks running, please wait...
      End of uninstall agent: 192.168.0.109
      End of uninstall agent: 192.168.0.39
      All hosts uninstall icagent finish.

      请耐心等待,当提示All hosts uninstall icagent finish.时,则表示配置文件中所有服务器的卸载操作已完成。

    2. 卸载完成后,在云日志服务左侧导航栏中选择“主机管理 > 主机”,查看该服务器的ICAgent状态。

查看ICAgent状态

左侧导航栏选择“主机管理 > 主机”,查看目标主机的ICAgent状态。详细请参见表1

表1 ICAgent状态

状态

说明

运行

该服务器的ICAgent运行正常。

未安装

该服务器未安装ICAgent。

安装中

正在为该主机安装ICAgent。安装ICAgent预计需要1分钟左右,请耐心等待。

安装失败

该主机的ICAgent安装失败。

升级中

正在升级该服务器的ICAgent。升级ICAgent预计需要1分钟左右,请耐心等待。

升级失败

该服务器的ICAgent升级失败。

离线

输入的AK/SK错误导致该主机的ICAgent功能异常。请获取正确的AK/SK后重新安装。

异常

该主机ICAgent功能异常,请联系技术支持。

卸载中

正在卸载该主机。卸载ICAgent预计需要1分钟左右,请耐心等待。

鉴权错误

安装该主机时配置的参数问题导致无法正常鉴权。