管理ICAgent

安装ICAgent

LTS支持对主机场景或容器场景下的目标服务器安装ICAgent。

主机场景

• 安装ICAgent

  详细操作请参考安装ICAgent（区域内主机）和安装ICAgent（区域外主机）。

• 升级ICAgent

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

  如果需要升级Windows环境中的ICAgent，请先卸载旧版本ICAgent，再安装新版本ICAgent即可。

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

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

     如果升级后，界面显示ICAgent状态异常或者其它升级失败场景，请直接登录节点使用安装命令重新安装ICAgent即可（覆盖式安装，无需卸载操作）。详细操作请参考安装ICAgent（区域内主机）和安装ICAgent（区域外主机）

容器场景

• CCE集群安装ICAgent
  1. 在左侧导航栏选择“主机管理 > 主机”，进入“主机”页面。
  2. 选择“CCE集群”，在搜索框中选择待升级ICAgent的集群，查看ICAgent状态显示未安装，单击“升级ICAgent”。
     图1 CCE集群升级ICAgent
     
     • 如果在LTS主机页面看不到CCE集群，需要AOM2.0授权给LTS后，就可以在LTS页面看到CCE集群。进入AOM2.0控制台后，请参考云服务授权授予云日志服务 (LTS)、云容器引擎 (CCE)等云服务数据的访问权限。
     • 未创建CCE集群时，采集容器标准输出到AOM的开关为置灰状态。
     • 当ICAgent版本号为5.12.133及以上时，支持关闭采集容器标准输出到AOM1.0的开关功能。
     • 首次创建的CCE集群，默认集群下的主机已安装了ICAgent且上报日志到LTS，采集容器标准输出到AOM的开关处于关闭状态；如需将日志上报至LTS则执行升级ICAgent操作时，关闭采集容器标准输出到AOM的开关。建议使用云容器引擎CCE应用日志接入LTS时直接采集容器标准输出到LTS，不推荐采集到AOM。
     • CCE集群ID（ClusterID）： 每个集群为固定的ID。
     • 升级ICAgent时，LTS将为您的CCE集群创建对应的日志组和主机组。且该日志组和主机组的名称为k8s-log-{ClusterID}。您可以创建接入配置时将当前CCE集群的日志接入到该日志组。详细请参考云容器引擎CCE应用日志接入LTS。
     • 当集群里的主机未安装ICAgent或ICAgent版本过低时，单击“升级ICAgent”操作，可对该集群里的所有主机安装ICAgent。
  3. 在“升级ICAgent”对话框中，单击“确定”开始升级ICAgent。

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

     图2 升级ICAgent
     
• 自建kubernetes集群安装ICAgent的方法请参考安装日志采集组件。
• CCE集群升级ICAgent的操作方法跟CCE集群安装ICAgent一样。
• 卸载ICAgent：

  请参考管理CCE集群的ICAgent插件。

升级ICAgent

LTS支持对主机场景或容器场景下的目标服务器升级ICAgent。

LTS会自动检测主机安装的ICAgent插件版本。 如果检测到您的主机中后期不维护的ICAgent插件版本时，当您进入LTS控制台后，界面会弹出“ICAgent版本太低”的提示框，您可以根据实际需求单击“授权自动升级”授权LTS为您在业务低峰期自动升级ICAgent插件，或单击“前往手动升级”前往主机管理页面升级ICAgent。如果您暂不需要升级ICAgent插件，可勾选“不再提示”前的复选框，取消提示信息。

• 主机场景：详细步骤请参考升级ICAgent。
• 容器场景：CCE集群升级ICAgent的操作方法跟CCE集群安装ICAgent一样。

卸载ICAgent

服务器上的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的方式，还可以对服务器进行远程卸载。

  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。

查看ICAgent版本说明

左侧导航栏选择“主机管理 > 主机”，查看目标主机的ICAgent版本。详细请参见表2。