文档中心

日志服务

安装与升级（Windows）

升级 LogCollector（Windows）

升级 LogCollector（Windows）

LogCollector 以 Windows 服务运行，采集主机上的文本日志。完成安装后，还需在 TLS 控制台关联机器组和采集规则，才能开始采集。

本文档介绍在 Windows 升级 LogCollector 操作。

前提条件

已安装 LogCollector，详情请参考安装 LogCollector（Windows）。

以管理员权限打开 PowerShell。

升级 LogCollector

单击 LogCollector 安装包地址，获取新版本安装包。

解压安装包到新的独立目录，例如 C:\Packages\LogCollector-new。

说明

请勿将新安装包解压覆盖旧安装目录。

备份旧版本 LogCollector 配置文件。

使用管理员 PowerShell，进入新安装包解压目录。

cd C:\Packages\LogCollector-new

执行以下命令升级 LogCollector。

.\logcollector_installer.exe upgrade

如果安装旧版本时指定过 --install-directory、--home，升级时必须保持与旧版本安装时一致”，并分别解释两者含义（程序目录 vs 数据/配置目录）

.\logcollector_installer.exe upgrade --install-directory "D:\LogCollector" --home "D:\LogCollectorData"

检查升级后服务状态。

检查退出码，退出码为 0 表示上一个命令执行成功。

$LASTEXITCODE

检查 LogCollector 服务状态，服务状态为 Running，表示升级安装成功。

Get-Service logcollector

若升级安装失败，先查看命令输出及安装器给出的诊断日志路径，不要反复执行安装或手动删除服务。

检查机器组心跳状态。

登录日志服务控制台，检查机器组心跳状态、日志采集是否正常。

注意事项

upgrade 为替换程序文件，仍保留现有配置和采集断点。

升级失败时安装器会尝试回滚，但仍须根据最终输出和服务状态确认最终升级结果。

升级 LogCollector 时请勿执行卸载操作，请勿使用install代替upgrade。

对已有安装再次执行install时，默认会报错，继续安装则会重新生成配置。

最近更新时间：2026.10.21 10:04:57

这个页面对您有帮助吗？

有用

有用

无用

无用