背景信息

为了提升云日志服务（LTS）的用户体验，让您享受到更优质的服务内容，云日志服务进行了系统架构升级，升级后LTS将使用新版Agent进行日志采集。

本次升级影响如下：

• 对于存量用户，有影响，存量用户需要将原采集器Telescope升级为新采集器ICAgent，即安装新版Agent，然后将旧版Agent（Telescope）中已经配置的日志采集数据一键导入新版Agent中。
• 对于全新用户，无影响，直接安装新版Agent即可。

目前仅“华北-北京一”、“华东-上海二”、“华南-广州”和“西南-贵阳一”区域支持Telescope Agent功能。

Agent升级流程

步骤一：获取AK/SK凭证

安装新版Agent之前，需要先获取AK/SK凭证。

1. 登录管理控制台。
2. 在“控制台”页面，鼠标移动至右上方的用户名，在下拉列表中选择“我的凭证”。
3. 在“我的凭证”页面，单击“访问密钥”页签。
4. 单击“新增访问密钥”，输入验证码。

   

5. 单击“确定”，生成并下载访问密钥。
   

   请妥善保存您的AK/SK凭证，安装ICAgent需要使用AK/SK凭证。

步骤二：安装新版Agent

1. 选择“服务列表 > 管理与部署 > 云日志服务”，进入云日志服务页面。
2. 在左侧导航栏，单击“Agent管理”，进入“Agent管理”页面。
3. 单击“安装ICAgent”。
4. 生成ICAgent安装命令。

   “安装方式”默认为“获取AK/SK凭证”，请在文本框中输入5中获取的AK/SK凭证，生成ICAgent安装命令。

5. 单击“复制命令”，复制ICAgent安装命令。

   

   

   请确保输入正确的AK/SK，否则将无法安装ICAgent。

6. 使用PuTTY等远程登录工具，以root用户登录待安装ICAgent的服务器，执行ICAgent安装命令进行安装。

   当显示“ICAgent install success”时，表示安装成功，ICAgent已安装在了/opt/oss/servicemgr/目录。

7. 安装成功后，在云日志服务左侧导航栏中选择“Agent管理”，查看该服务器ICAgent的状态。

   

步骤三：一键导入采集配置数据

通过一键导入的方式，可以将旧版Agent（Telescope）中已经配置的日志采集信息，一键升级至新版Agent（ICAgent）中，新版Agent将按照导入的日志采集信息，继续采集日志。

1. 在Agent管理页面，单击“Telescope Agent管理”页签。
2. Telescope Agent管理页面，单击 ，展开实例名称，记录“日志格式”、“日志组”、“日志流”和“路径”等信息。
3. 单击右侧的“一键导入”，导入Telescope Agent中已配置的日志采集信息。
   

   • 如果存在多个实例，请依次按照以上步骤进行导入操作。
   • 安装完新版Agent后，进行一键导入操作时，系统将采用平行策略（新版旧版Agent同时采集日志），保证日志数据不丢失，平稳迁移。

步骤四：查看导入后的日志

一键导入采集配置数据后，大约2分钟后生效，需要进入对应日志流页面，查看采集配置数据是否导入成功。

1. 在左侧导航栏，单击“日志管理”，进入日志管理页面。
2. 在日志组列表中，单击2中记录的日志组，进入日志流列表页面。
3. 在日志流列表中，单击2中记录的日志流，进入日志流页面。
4. 单击“日志接入-主机接入”，查看“主机名称”、“日志格式”、“日志采集路径”等日志采集配置信息，是否跟导入的旧版Agent（Telescope）中的一致。

   

5. 单击“日志流-实时日志”，查看实时日志。

   

   

   • 历史的日志数据由系统自动导入。
   • 如果日志采集配置数据不一致，或者没有日志数据，表示一键导入失败，请重新导入或者联系技术工程师处理。

步骤五：删除旧版采集路径

日志采集配置数据导入成功后，请删除旧版Agent（Telescope）中采集日志的实例，否则同时存在两个日志采集器，会导致日志重复采集上报，产生重复数据。

1. 在Agent管理页面，单击“Telescope Agent管理”页签。
2. 单击实例右侧的“删除”，删除Telescope Agent中已配置的日志采集信息。
   

   删除操作表示删除旧版Agent（Telescope）中配置的采集日志路径，并非卸载Telescope，删除后，Telescope将不再向LTS上报日志，如果需要卸载Telescope，可以执行以下命令：

   /usr/local/telescope/uninstall.sh