文档中心

日志服务

安装与升级（Windows）

安装 LogCollector（Windows）

LogCollector 是日志服务提供的日志采集客户端，用于快速上报日志数据。在服务器中安装 LogCollector 之后，通过控制台或配置文件即可下发采集规则、快速接入日志服务。

本文档介绍在 Windows 安装、卸载 LogCollector 等操作。

准备工作

已有可用的 Windows x86-64 操作系统。

预先根据服务器类型和所在地域，确定安装 LogCollector 时所需的网络类型。

已创建 IAM 用户，获取 Access Key ID、Secret Access Key。并至少为用户授予日志服务（TLS）采集预置策略TLSLogCollectorAccess权限策略，权限详情可参考 IAM 概述。

使用限制

限制	说明
Windows 版本	LogCollector 支持多个 Windows 操作系统，推荐您使用以下经过兼容性测试的操作系统版本。 Windows 10（1709 及以后） Windows 11 Windows Server 2019 Windows Server 2022 Windows Server 2025 Windows Server Version 1909/2004
LogCollector 版本	适用于 LogCollector 2.4.6 及以后版本。
LogCollector 升级	暂不支持通过控制台下发升级 LogCollector 任务。升级需在主机上使用新版本安装包重新安装，详情请参考升级 LogCollector（Windows）。
安装管理	需确保程序目录、数据目录及安装包解压目录位于本地 NTFS 卷，彼此不能相同或相互嵌套。暂不支持 ReFS、exFAT、FAT32、UNC 网络路径和网络映射盘。暂不支持 Windows Event Log、Windows 容器及 Kubernetes 自动发现。
采集路径	仅支持采集本地 NTFS 卷。仅支持采集路径为带盘符的绝对路径。例如 C:\App\logs\.log或 C:/App/logs/.log。
采集文件	仅支持采集允许其他进程共享读取的文件，LogCollector 无法采集应用独占打开的文件。 LogCollector 正在读取文件时，应用若尝试以独占方式重新打开，可能会打开失败。如果无法调整应用的打开方式时，请采集已关闭的轮转文件，并确保文件保留到采集完成。

安装 LogCollector

一获取并解压安装包

获取 LogCollector Windows x86-64 安装包。

安装包地址：

https://logcollector-{Region ID}.tos-{Region ID}.volces.com/windows/LogCollector2.4.6.zip

以亚太东南（柔佛）为例：

https://logcollector-ap-southeast-1.tos-ap-southeast-1.volces.com/windows/LogCollector2.4.6.zip

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

请保留解压后的全部文件，包括 logcollector_installer.exe、其他程序文件和 SHA256SUMS。

安装器会校验包内容，不要只复制安装器，也不要把安装包直接解压到已安装的程序目录。

二执行安装

使用管理员 PowerShell，进入解压目录。

cd C:\Packages\LogCollector

替换命令中的 Endpoint 和凭证为实际环境信息：

.\logcollector_installer.exe install --region ap-southeast-1 --endpoint "<TLS 服务 Endpoint>" --secret_id "<AccessKey ID>" --secret_key "<Secret AccessKey>" --label "windows-agent"

（可选）如果需要自定义 CPU、内存、LogCollector 程序目录和数据目录时，可在安装命令末尾添加：

--cpu "200%" --memory "2G" --install-directory "D:\LogCollector" --home "D:\LogCollectorData"

说明

使用自定义的程序目录和数据目录后，升级 LogCollector 时需要使用相同目录。且均需位于本地 NTFS 卷，彼此不能相同或相互嵌套。

安装器诊断日志仍写入系统ProgramData目录下，不随--home改变。

参数	是否必选	示例	说明
region	必选	ap-southeast-1	日志项目所在的地域。日志服务地域及对应 ID 请参考服务入口。
endpoint	必选	https://tls-ap-southeast-1.volces.com	日志服务连接域名，即服务地址。登录日志服务控制台后，您可以在日志项目的详情页中查看连接域名。详细说明请参考服务入口。
secret_id	必选	AK********	火山引擎账号或 IAM 账号的 Access Key ID。您可以在火山引擎控制台密钥管理页面，获取 Access Key ID。
secret_key	必选	TUdZ********	火山引擎主账号或 IAM 用户的 Secret Access Key。您可以在火山引擎控制台密钥管理页面，获取 Secret Access Key。
label	必选	windows-agent	LogCollector 的 label 标识。如果需要将此 LogCollector 加入机器标识类型的机器组中，则必须设置 label 参数。同时，您在创建机器标识类型的机器组时，需设置机器标识为该 label。详细说明，请参考机器组概述。支持配置多个 label 标识，通过逗号（,）分隔。不支持同时设置 ip 和 label。
memory	可选	2G	允许 LogCollector 使用的内存阈值，默认为 2G。内存使用超过限制后，LogCollector 可能被限制、终止或重启。
cpu	可选	200%	允许 LogCollector 使用的 CPU 阈值，默认为 200%。

三验证安装

检查安装

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

$LASTEXITCODE

检查 LogCollector 服务状态，服务状态为 Running，表示本机安装与启动成功。

Get-Service logcollector

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

默认路径

配置项	默认路径
LogCollector 程序	C:\Program Files\LogCollector
LogCollector 配置文件	C:\ProgramData\LogCollector\config\logcollector.yml
LogCollector 运行日志	C:\ProgramData\LogCollector\logs
运行数据与采集断点数据	C:\ProgramData\LogCollector\data
安装器诊断日志	C:\ProgramData\LogCollector\installer-logs

在 TLS 控制台配置采集规则并验证

LogCollector 安装成功和机器组心跳正常只证明服务已接入，是否真正采集成功，应以新写入日志的查询结果为准。

若未查到日志，依次检查采集规则、采集路径、文件读取权限和 LogCollector 运行日志等。

登录日志服务控制台。

创建机器标识机器组，详情请参考创建机器组（机器标识）。

机器标识填写安装命令中的label字段，例如 windows-agent。

确认该主机已加入机器组，且心跳正常。

创建采集规则并关联该机器组，详情请参考单行全文模式。

采集路径需配置为带盘符的绝对路径，例如 C:\App\logs\*.log。

验证日志是否采集成功，详情请参考单主题检索日志。

向待采集的文件写入一条带唯一标识的新日志，在目标日志主题中查询该标识。

管理 LogCollector

正常运维操作请通过 Windows 服务管理方式启停，不要直接结束进程。

在管理员 PowerShell 中查看或控制服务命令如下：

操作	命令
获取 LogCollector 状态	Get-Service logcollector
停止 LogCollector	Stop-Service logcollector
启动 LogCollector	Start-Service logcollector
重启 LogCollector	Restart-Service logcollector

卸载 LogCollector

卸载会停止并移除 Windows 服务，但保留程序文件、配置、运行日志和采集断点。

执行以下命令卸载 LogCollector。

使用当前已安装程序目录中的安装器执行以下命令，以默认程序目录为例：

& "C:\Program Files\LogCollector\logcollector_installer.exe" uninstall

执行以下命令检查服务是否存在。

Get-Service logcollector -ErrorAction SilentlyContinue

清理程序文件。

在确认服务已移除、不再需要数据后，再手动清理目录，如C:\Program Files\LogCollector等。

若卸载失败或服务处于待删除状态，请保留安装器日志交由运维排查，请勿反复删除服务或直接修改注册表。

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

这个页面对您有帮助吗？

有用

无用