安装 LogCollector（宿主机）--日志服务-火山引擎

文档中心

导航

安装 LogCollector（宿主机）

最近更新时间：2025.01.10 12:27:43首次发布时间：2021.10.11 18:04:05

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 时所需的网络类型。

安装并启动

1 下载 LogCollector 安装脚本

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

说明

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

私网下载地址

华南1（广州）

华北2（北京）

华东2（上海）

柔佛（亚太东南）

wget https://logcollector-cn-guangzhou.tos-cn-guangzhou.ivolces.com/logcollector.sh -O logcollector.sh; sudo chmod 755 logcollector.sh

公网下载地址

华南1（广州）

华北2（北京）

华东2（上海）

柔佛（亚太东南）

wget https://logcollector-cn-guangzhou.tos-cn-guangzhou.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 。

sudo ./logcollector.sh install --region {region} --endpoint {endpoint} --secret_id {secret_id} --secret_key {secret_key} --label {label}

其中，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` 和 `label`。如果未设置 `ip`，LogCollector 会根据一定策略自动获取 IP 地址，您可以在安装路径下 agent_info.json 文件中查看 ip 字段记录的 IP 地址。IP 地址获取策略请参考为宿主机或容器设置 IP 地址。

3 查看 LogCollector 的运行状态

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

systemctl status logcollectord.service

相关操作

1 修改 LogCollector 配置文件

在 LogCollector 的运行过程中，如果需要修改 secret_id和secret_key 等鉴权参数，或者 label 等 LogCollector 标识参数，可以执行如下命令修改 LogCollector 配置文件。

sudo /usr/local/logcollector/tools/logcollector.sh update_config --region {region} --endpoint {endpoint} --secret_id {secret_id} --secret_key {secret_key} --label {label}

其中，region、endpoint、secret_id和secret_key 等参数的详细说明同上。

2 查看软件版本

执行以下命令，查看当前设备所安装的 LogCollector 版本号。

/usr/local/logcollector/logcollector -v

3 进程管理

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

4 卸载 LogCollector

说明

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

执行以下命令卸载 LogCollector。

sudo /usr/local/logcollector/tools/logcollector.sh uninstall