文档中心

日志服务

请输入

安装与升级

升级 LogCollector（宿主机）

LogCollector 支持自动升级和手动升级，LogCollector V2.3.1及以后版本支持直接在日志服务控制台执行升降级。

本文档介绍升级 V2.3.1之前版本 LogCollector 的操作步骤。

注意

从 Logcollector v2.2.0 版本开始，systemd service 名称由 filebeatd 变更为logcollectord。

背景信息

为保证日志采集的稳定性与高效性，建议您始终使用最新版本的 LogCollector 采集 Linux 服务器文本日志。日志服务提供自动升级 LogCollector 和手动升级 LogCollector 两种升级方式。

升级方式	说明
自动升级	您在创建机器组时开启 LogCollector 自动升级后，LogCollector 将在指定的自动升级时间内进行升级检查，如果满足升级条件，则 LogCollector 将自动升级到最新线上版本。建议您将自动升级时间设置为业务低峰期。说明 LogCollector 自动升级会重启 LogCollector，但不会导致 LogCollector 重复采集或者漏采集日志。只有安装在 Linux 服务器中的 LogCollector 支持自动升级，自建 Kubernetes 机器、火山 VKE、火山 VCI 暂不支持自动升级。
手动升级	关闭了LogCollector 自动升级功能的机器组，或不满足 LogCollector 版本要求的机器组，只能手动升级 LogCollector。即您需要手动下载最新的安装脚本，并手动执行升级命令。

自动升级 LogCollector

自动升级条件

LogCollector 仅在满足以下所有升级条件的情况下，才会执行自动升级操作。

检查项	说明
当前 LogCollector 版本是否为 V1.0.8 及后续版本。	仅 V1.0.8 及后续版本的 LogCollector 才支持自动升级。如果当前的 LogCollector 版本不满足需求，请参考手动升级 LogCollector，手动升级到最新版本后，再使用自动升级功能。

自动升级操作步骤

Tip

手动升级 LogCollector

下载 LogCollector 安装脚本

根据 Linux 服务器的地域与网络类型，执行对应的下载命令，下载 LogCollector 安装脚本到指定目录下。

推荐使用私网下载地址，节约公网流量费用。

下载地址中的 Region ID 请替换为实际环境对应地域的 ID，如华北2（北京）地域为cn-beijing。支持的地域请参考服务地址列表。

wget https://logcollector-<Region ID>.tos-<Region ID>.ivolces.com/logcollector.sh -O logcollector.sh; sudo chmod 755 logcollector.sh

wget https://logcollector-<Region ID>.tos-<Region ID>.volces.com/logcollector.sh -O logcollector.sh; sudo chmod 755 logcollector.sh

升级并启动 LogCollector

执行以下命令手动升级 LogCollector。

sudo ./logcollector.sh upgrade --region <region>

其中，region 为必选参数，详细说明如下。

参数	是否必选	示例	说明
region	必选	cn-beijing	日志项目地域。日志服务地域及对应 ID 请参考服务地址。用于下载新版本 LogCollector。

最近更新时间：2026.08.26 14:14:29

这个页面对您有帮助吗？

有用

无用