文档中心

日志服务

安装与升级

安装 LogCollector（宿主机）

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

本文档介绍在 Linux 服务器上安装、升级或卸载 LogCollector 等操作。

注意

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

准备工作

已有可用的 Linux 服务器。

LogCollector 目前支持 Linux x86-64（64位）、ARM 操作系统，不支持 Windows 操作系统。

在 Linux 服务器上安装 systemd 和 wget 程序。

使用具备 root 权限的用户登录 Linux 服务器，完成本文操作。

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

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

安装并启动

1 下载 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

2 安装并启动 LogCollector

执行以下命令安装 LogCollector。安装完成后，会自动启动 LogCollector 进程。

说明

如果已经安装 LogCollector，那么执行下述命令时会输出提示信息 do you want to continue the installation? (y/n):。如果希望默认继续安装，请在命令中添加 --continue_installation true。

如果 LogCollector 正在运行，那么执行下述命令时会输出提示信息 logcollectord is running, please stop logcollectord first。如果希望默认继续安装，请在命令中添加 --directly_stop true 。

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

参数	是否必选	示例	说明
region	必选	cn-beijing	日志项目所在的地域。日志服务地域及对应 ID 请参考服务入口。
endpoint	必选	https://tls-cn-beijing.ivolces.com	日志服务连接域名，即服务地址。登录日志服务控制台后，您可以在日志项目的详情页中查看连接域名。详细说明请参考服务入口。
secret_id	必选	AK********	火山引擎账号或 IAM 账号的 Access Key ID。您可以在火山引擎控制台密钥管理页面，获取 Access Key ID。
secret_key	必选	TUdZ********	火山引擎主账号或 IAM 用户的 Secret Access Key。您可以在火山引擎控制台密钥管理页面，获取 Secret Access Key。
label	可选（建议设置）	http_module	LogCollector 的 label 标识。如果需要将此 LogCollector 加入机器标识类型的机器组中，则必须设置 label 参数。同时，您在创建机器标识类型的机器组时，需设置机器标识为该 label。详细说明，请参考机器组概述。支持配置多个 label 标识，通过逗号（,）分隔。不支持同时设置 ip 和 label。
ip	可选	10.1.1.*	LogCollector 的 IP 地址。如果需要将此 LogCollector 加入 IP 地址类型的机器组中，则建议设置 ip 参数，此时 LogCollector 的 IP 地址为设置的 IP 地址。如果未设置 ip，LogCollector 会根据一定策略自动获取 IP 地址，您可以在安装路径下 agent_info.json 文件中查看 ip 字段记录的 IP 地址。IP 地址获取策略请参考为宿主机或容器设置 IP 地址。不支持同时设置 ip 和 label。
memory	可选	2G	允许 LogCollector 使用的内存阈值，默认为 2G。内存使用超过限制后，会触发 OOM Killer 机制。
cpu	可选	200%	允许 LogCollector 使用的 CPU 阈值，默认为 200%。

3 查看 LogCollector 的运行状态

执行以下命令查看 LogCollector 的运行状态，如果返回结果的 Active 属性为 active (running)……，则表示安装 LogCollector 成功且 LogCollector 运行状态正常。

操作	命令
查看 LogCollector 运行状态	sudo systemctl status logcollectord.service
启动 LogCollector	sudo systemctl start logcollectord.service
停止 LogCollector	sudo systemctl stop logcollectord.service
重启 LogCollector	sudo systemctl restart logcollectord.service