LogCollector 是日志服务基于开源日志采集工具 Filebeat 二次开发的日志采集客户端，用于快速上报日志数据。在服务器中安装 LogCollector 之后，通过控制台或配置文件即可下发采集规则、快速接入日志服务。本文档介绍在 Linux 服务器上安装、升级或卸载 LogCollector 等操作。

背景信息

Filebeat 是 Elastic 开发的开源日志采集工具，将其部署到服务器之后，可以采集服务器文本日志到 ElasticSearch、Kafka、Logstash 等进行二次处理。火山引擎日志服务基于开源的 Filebeat 工具进行二次开发，适配了日志服务的服务端功能、增加多种日志解析模式，改造为 LogCollector 对外正式提供服务。
LogCollector 兼容开源 Filebeat 的多种特性，实时监听并上报日志数据，提高日志采集效率与性能。

准备工作

• 一台符合安装环境要求的 Linux 服务器。
• 预先根据服务器类型和所在地域，确定采集日志时所需的网络类型。

安装环境

LogCollector 支持多个 Linux 操作系统，推荐您使用以下经过兼容性测试的操作系统版本。

安装并启动

1 下载 LogCollector

根据地域与网络类型，执行对应的下载命令，下载 LogCollector 到指定目录下。

私网下载地址

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

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

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

wget https://logcollector-ap-southeast-1.tos-ap-southeast-1.ivolces.com/logcollector.sh -O logcollector.sh; chmod 755 logcollector.sh

公网下载地址

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

wget https://logcollector-cn-beijing.tos-cn-beijing.volces.com/logcollector.sh -O logcollector.sh; chmod 755 logcollector.sh

wget https://logcollector-cn-shanghai.tos-cn-shanghai.volces.com/logcollector.sh -O logcollector.sh; chmod 755 logcollector.sh

wget https://logcollector-ap-southeast-1.tos-ap-southeast-1.volces.com/logcollector.sh -O logcollector.sh; chmod 755 logcollector.sh

2 安装并启动 LogCollector

执行以下命令安装 LogCollector。安装完成后，会自动启动 LogCollector 进程。启动后，Logcollector 进程变为运行状态，开始尝试与日志服务的服务端进行通信。

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

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

3 查看安装结果

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

systemctl status filebeatd.service

相关操作

修改鉴权参数、机器标识等配置

LogCollector 运行过程中，如果需要修改 endpoint 等鉴权和机器组标识等相关参数，可以通过以下任意一种方式修改。

方法1：（推荐）重新安装

停止 LogCollector 之后，重新执行安装命令，并填写正确的参数，参数说明请参考2 安装并启动 LogCollector。最后再次启动 LogCollector 即可。

#停止 LogCollector。
systemctl stop    filebeatd.service
#重新执行安装命令，修改鉴权参数。
./logcollector.sh init --endpoint https://tls-cn-beijing.ivolces.com --secret_id {AccessKeyID} --secret_key {AccessKeySecret} --region {region}
systemctl start   filebeatd.service

方法2：修改配置文件

在目录 filebeat-7.12.0/etc 中找到 LogCollector 配置文件 filebeat.yml，其中的 output.tls 部分默认为初始化时填写的 endpoint、ip 等配置参数，初始化之后您可以随时修改这些参数，修改完成后重启 LogCollector 即可生效。
配置文件 filebeat.yml 示例如下。

filebeat:   

output.tls:
  endpoint: 'https://tls-cn-beijing.ivolces.com'  #--日志服务的服务地址
  secret_id: Your Secrect Id                      #--火山引擎账号密钥Access Key ID。
  secret_key: Your Secrect Key                    #--火山引擎账号密钥Secret Access Key。
  region: cn-beijing                              #--日志项目的所在地域（Region）。
  compress_type: lz4                              #--压缩类型，建议维持默认设置lz4
  ip: 10.1.x.x                                    #--手动指定的宿主机 IP 地址
logging.level: info                               #--filebeat日志级别
logging.to_files: true
logging.files:
  name: filebeat
  keepfiles: 7
  permissions: 0644

查看软件版本

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

/etc/init.d/filebeatd -v

进程管理

systemctl status filebeatd.service

systemctl start   filebeatd.service

systemctl stop    filebeatd.service

systemctl restart filebeatd.service

卸载 LogCollector

以管理员权限执行以下命令卸载 LogCollector。

cd /usr/local/filebeat-7.12.0/tools/ && ./filebeat.sh uninstall
#或
cd /usr/local/filebeat-7.12.0/tools/ && ./logcollector.sh uninstall