LogCollector 是日志服务提供的日志采集客户端，用于快速上报日志数据。在服务器中安装 LogCollector 之后，通过控制台或配置文件即可下发采集规则、快速接入日志服务。本文档介绍在 Windows 安装、卸载 LogCollector 等操作。 ## 准备工作 * 已有可用的 Windows x86\-64 操作系统。 * 预先根据服务器类型和所在地域，确定安装 LogCollector 时所需的网络类型。 * 已创建 IAM 用户，获取 Access Key ID、Secret Access Key。并至少为用户授予日志服务（TLS）采集预置策略`TLSLogCollectorAccess`权限策略，权限详情可参考 [IAM 概述](https://docs.volcengine.com/docs/6470/103036)。 ## 使用限制 |限制 |说明 | |---|---| |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）](https://docs.volcengine.com/docs/6470/2731279)。 | |安装管理 |* 需确保程序目录、数据目录及安装包解压目录位于本地 NTFS 卷，彼此不能相同或相互嵌套。

* 暂不支持 ReFS、exFAT、FAT32、UNC 网络路径和网络映射盘。

* 暂不支持 Windows Event Log、Windows 容器及 Kubernetes 自动发现。 | |采集路径 |* 仅支持采集本地 NTFS 卷。

* 仅支持采集路径为带盘符的绝对路径。例如 `C:\App\logs\*.log`或 `C:/App/logs/*.log`。 | |采集文件 |* 仅支持采集允许其他进程**共享**读取的文件，LogCollector 无法采集应用独占打开的文件。

* LogCollector 正在读取文件时，应用若尝试以独占方式重新打开，可能会打开失败。如果无法调整应用的打开方式时，请采集已关闭的轮转文件，并确保文件保留到采集完成。 | ## 安装 LogCollector ### 一获取并解压安装包 1. 获取 LogCollector Windows x86\-64 安装包。安装包地址： ```Plain Text https://logcollector-{Region ID}.tos-{Region ID}.volces.com/windows/LogCollector2.4.6.zip ``` 以亚太东南（柔佛）为例： ```Plain Text https://logcollector-ap-southeast-1.tos-ap-southeast-1.volces.com/windows/LogCollector2.4.6.zip ``` 2. 解压安装包到独立目录，例如`C:\Packages\LogCollector`。 * 请保留解压后的全部文件，包括 `logcollector_installer.exe`、其他程序文件和 `SHA256SUMS`。 * 安装器会校验包内容，不要只复制安装器，也不要把安装包直接解压到已安装的程序目录。 ### 二执行安装 1. 使用管理员 PowerShell，进入解压目录。 ```PowerShell cd C:\Packages\LogCollector ``` 2. 替换命令中的 Endpoint 和凭证为实际环境信息： ```PowerShell .\logcollector_installer.exe install --region ap-southeast-1 --endpoint "" --secret_id "" --secret_key "" --label "windows-agent" ``` （可选）如果需要自定义 CPU、内存、LogCollector 程序目录和数据目录时，可在安装命令末尾添加： ```PowerShell --cpu "200%" --memory "2G" --install-directory "D:\LogCollector" --home "D:\LogCollectorData" ``` > **说明** * > 使用自定义的程序目录和数据目录后，升级 LogCollector 时需要使用相同目录。且均需位于本地 NTFS 卷，彼此不能相同或相互嵌套。 * > 安装器诊断日志仍写入系统`ProgramData`目录下，不随`--home`改变。 |参数 |是否必选 |示例 |说明 | |---|---|---|---| |region |必选 |ap\-southeast\-1 |日志项目所在的地域。

日志服务地域及对应 ID 请参考[服务入口](https://docs.volcengine.com/docs/6470/73641)。 | |endpoint |必选 |https://tls\-ap\-southeast\-1.volces.com |日志服务连接域名，即服务地址。

登录[日志服务控制台](https://console.volcengine.com/tls)后，您可以在日志项目的详情页中查看连接域名。详细说明请参考[服务入口](https://docs.volcengine.com/docs/6470/73641)。 | |secret_id |必选 |AK\*\*\*\*\*\*\*\* |火山引擎账号或 IAM 账号的 Access Key ID。

您可以在火山引擎控制台[密钥管理页面](https://console.volcengine.com/iam/keymanage/)，获取 Access Key ID。 | |secret_key |必选 |TUdZ\*\*\*\*\*\*\*\* |火山引擎主账号或 IAM 用户的 Secret Access Key。

您可以在火山引擎控制台[密钥管理页面](https://console.volcengine.com/iam/keymanage/)，获取 Secret Access Key。 | |label |必选 |windows\-agent |LogCollector 的 label 标识。

* 如果需要将此 LogCollector 加入**机器标识**类型的机器组中，则必须设置 `label` 参数。同时，您在创建机器标识类型的机器组时，需设置**机器标识为**该 label。详细说明，请参考[机器组概述](https://docs.volcengine.com/docs/6470/107374)。

* 支持配置多个 label 标识，通过逗号（,）分隔。

* 不支持同时设置 `ip` 和 `label`。 | |memory |可选 |2G |允许 LogCollector 使用的内存阈值，默认为 2G。

内存使用超过限制后，LogCollector 可能被限制、终止或重启。 | |cpu |可选 |200% |允许 LogCollector 使用的 CPU 阈值，默认为 200%。 | ### 三验证安装 * 检查安装 1. 检查退出码，退出码为 `0` 表示上一个命令执行成功。 ```PowerShell $LASTEXITCODE ``` 2. 检查 LogCollector 服务状态，服务状态为 `Running`，表示本机安装与启动成功。 ```PowerShell 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 运行日志等。 1. 登录[日志服务控制台](https://console.volcengine.com/tls)。 2. 创建机器标识机器组，详情请参考[创建机器组（机器标识）](https://docs.volcengine.com/docs/6470/107375)。 * 机器标识填写安装命令中的`label`字段，例如 `windows-agent`。 * 确认该主机已加入机器组，且心跳正常。 3. 创建采集规则并关联该机器组，详情请参考[单行全文模式](https://docs.volcengine.com/docs/6470/93981)。采集路径需配置为带盘符的绝对路径，例如 `C:\App\logs\*.log`。 4. 验证日志是否采集成功，详情请参考[单主题检索日志](https://docs.volcengine.com/docs/6470/1206094)。向待采集的文件写入一条带唯一标识的新日志，在目标日志主题中查询该标识。 ## 管理 LogCollector 正常运维操作请通过 Windows 服务管理方式启停，不要直接结束进程。在管理员 PowerShell 中查看或控制服务命令如下： |操作 |命令 | |---|---| |获取 LogCollector 状态 |```PowerShell```
```Get-Service logcollector```
| |停止 LogCollector |```PowerShell```
```Stop-Service logcollector```
| |启动 LogCollector |```PowerShell```
```Start-Service logcollector```
| |重启 LogCollector |```PowerShell```
```Restart-Service logcollector```
| ## 卸载 LogCollector 卸载会停止并移除 Windows 服务，但保留程序文件、配置、运行日志和采集断点。 1. 执行以下命令卸载 LogCollector。使用**当前已安装程序目录中的安装器**执行以下命令，以默认程序目录为例： ```PowerShell & "C:\Program Files\LogCollector\logcollector_installer.exe" uninstall ``` 2. 执行以下命令检查服务是否存在。 ```PowerShell Get-Service logcollector -ErrorAction SilentlyContinue ``` 3. 清理程序文件。 * 在确认服务已移除、不再需要数据后，再手动清理目录，如`C:\Program Files\LogCollector`等。 * 若卸载失败或服务处于待删除状态，请保留安装器日志交由运维排查，请勿反复删除服务或直接修改注册表。