日志服务 LogListener 安装指南（Linux 版）

LogListener 是腾讯云日志服务（Cloud Log Service，CLS）所提供的专用日志采集器，将它安装部署到服务器上，可快速采集日志到日志服务。
安装环境
本文将介绍 Linux 操作系统环境下 LogListener 的安装，Windows 操作系统请参见 LogListener 安装指南（Windows版）。
说明：
如果其他版本环境若安装异常，请 提交工单 联系我们。
LogListener 版本
处理器架构
操作系统类别
确定可安装环境
v2.x.x
x64/ARM
TencentOS Server
TencentOS Server 3.1、TencentOS Server 2.4
﻿
﻿
CentOS（64位）
CentOS_6.8_64位、CentOS_6.9_64位、CentOS_7.2_64位、CentOS_7.3_64位、CentOS_7.4_64位、CentOS_7.5_64位、CentOS_7.6_64位、CentOS_8.0_64位
﻿
﻿
Ubuntu（64位）
Ubuntu Server_14.04.1_LTS_64位、Ubuntu Server_16.04.1_LTS_64位、Ubuntu Server_18.04.1_LTS_64位、Ubuntu Server_20.04.1_LTS_64位、Ubuntu Server_22.04.1_LTS_64位、
﻿
﻿
Debian（64位）
Debian_8.2_64位、Debian_9.0_64位
﻿
﻿
openSUSE（64位）
openSUSE_42.3_64位
支持功能
LogListener 详细版本功能变更信息请参见 LogListener 版本变更。
操作步骤
步骤1：下载安装 LogListener
以安装路径/usr/local/为例：下载 LogListener 安装包并解压，解压路径为/usr/local/ ，解压完成后进入 LogListener 目录/usr/local/loglistener/tools，执行安装命令 。
x64架构
ARM 架构
说明：
从2.8.3版本开始，Loglistener 安装包不再添加版本号后缀，使用 loglistener-linux-x64 默认安装 LogListener 最新版本。
如果需要安装特定版本可以在后面指定版本号，如将 loglistener-linux-x64替换为 loglistener-linux-x64-2.8.0，将会指定安装2.8.0版本。
公网环境
wget http://mirrors.tencent.com/install/cls/loglistener-linux-x64.tar.gz && tar zxvf loglistener-linux-x64.tar.gz  -C /usr/local/ && cd /usr/local/loglistener/tools && ./loglistener.sh install
内网环境
wget http://mirrors.tencentyun.com/install/cls/loglistener-linux-x64.tar.gz && tar zxvf loglistener-linux-x64.tar.gz  -C /usr/local/ && cd /usr/local/loglistener/tools && ./loglistener.sh install
公网环境
wget http://mirrors.tencent.com/install/cls/loglistener-linux-ARM-2.9.0.tar.gz && tar zxvf loglistener-linux-ARM-2.9.0.tar.gz  -C /usr/local/ && cd /usr/local/loglistener/tools && ./loglistener.sh install
内网环境
wget http://mirrors.tencentyun.com/install/cls/loglistener-linux-ARM-2.9.0.tar.gz && tar zxvf loglistener-linux-ARM-2.9.0.tar.gz  -C /usr/local/ && cd /usr/local/loglistener/tools && ./loglistener.sh install
步骤2：初始化 LogListener
以安装路径/usr/local/为例，在/usr/local/loglistener/tools路径下，以 root 权限执行 LogListener 初始化命令，初始化命令如下：
./loglistener.sh init -secretid AKID******************************** -secretkey ******************************** -region ap-xxxxxx
说明：
初始化命令中 -secretid、-secretkey、-region 为必填的参数，更多其他参数请见如下 参数说明。
若主账号已授权协作者日志服务的读写权限，建议使用协作者密钥。
-region 为您所使用的日志服务区域，而非您的业务机器所处的区域。当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请额外配置参数-network 为 internet，即代表外网访问。
云服务器与日志集同地域的情况下，建议使用内网方式访问服务域名；云服务器与日志集在不同地域的情况下，建议使用外网方式访问服务域名。
关于日志采集权限详情，请参见 LogListener 日志采集权限。
参数说明
参数名
是否必填
类型描述
secretid
是
﻿云 API 密钥 的一部分，SecretId 用于标识 API 调用者身份。请确保云 API 密钥关联的账号具有相应的 LogListener 日志采集权限。
secretkey
是
﻿云 API 密钥 的一部分，SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥。请确保云 API 密钥关联的账号具有相应的 LogListener 日志采集权限。
encryption
否
是否对云API密钥进行加密存储。 详情请参见 密钥加密存储。
network
否
表示 LogListener 通过哪种方式访问服务域名，取值：intra 内网访问（默认），internet 外网访问。
内网访问：适用于腾讯云服务器，且服务器所在地域与机器组一致。
外网访问：适用于非腾讯云服务器，或服务器所在地域与机器组不一致。
region
若配置了 domain，该参数无需配置，否则必填
region 表示日志服务所在的 地域，此处填写域名简称，例如 ap-beijing、ap-guangzhou 等。
注意：
当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请配置参数 network 为 internet，即代表外网访问。
domain
若配置了 region，该参数无需配置，否则必填
表示日志服务所在地域的 域名。例如 ap-beijing.cls.tencentyun.com、ap-guangzhou.cls.tencentyun.com 等。
注意：
当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请配置外网域名。例如 ap-beijing.cls.tencentcs.com。
ip
否
机器的 IP 地址，机器组可通过所配 IP 地址与该机器关联，详情请参见 机器组。若不填写，LogListener 会自动获取本机的 IP 地址。 
label
否
机器标识，填写后该机器将与同样带有所填机器标识的机器组关联，详情请参见 机器组。多个标识按逗号分隔。
注意：
若配置了机器标识， 该机器将只能通过机器标识与机器组关联， 无法通过 IP 进行关联；若不配置， 机器组只能通过 IP 关联该机器。
初始化成功返回样例
﻿
﻿
﻿
步骤3：启动 LogListener
通过 systemd 执行
不通过 systemd 执行
适用于 Loglistener 2.8.3以上并且操作系统具有 systemd。
systemctl start loglistenerd
执行 /etc/init.d/loglistenerd check 查看是否启动成功：
﻿
﻿
适用于 LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。
/etc/init.d/loglistenerd start
启动成功返回样例：
﻿
﻿
﻿
步骤4：加入机器组
完成 LogListener 安装并启动后，需在 日志服务控制台 创建或选择已有 机器组，并将服务器加入机器组中。您可通过以下两种方式将服务器加入机器组：
﻿通过关联机器 IP 地址创建机器组﻿
﻿通过机器标识创建机器组 
步骤5：采集日志
将服务器加入机器组后，即可 配置采集服务器上的文本日志。
LogListener 常用操作
说明：
本文档示例的操作命令说明仅适用于 LogListener-2.2.4及以上版本，低版本操作命令请参见 低版本 LogListener 操作指南。
查看 LogListener 版本
/etc/init.d/loglistenerd -v
查看 LogListener 帮助文档
/etc/init.d/loglistenerd -h
停止 LogListener
通过 systemd 执行
不通过 systemd 执行
适用于 Loglistener 2.8.3以上并且操作系统具有 systemd。
systemctl stop loglistenerd
适用于 LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。
/etc/init.d/loglistenerd stop
重启 LogListener
通过 systemd 执行
不通过 systemd 执行
适用于 Loglistener 2.8.3以上并且操作系统具有 systemd。
systemctl restart loglistenerd
执行 /etc/init.d/loglistenerd check 查看是否重启成功：
﻿
﻿
﻿
适用于 LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。
/etc/init.d/loglistenerd restart
重启成功返回样例：
﻿
﻿
﻿
查看 LogListener 进程状态
/etc/init.d/loglistenerd status
LogListener 正常情况会运行两个进程：
﻿
﻿
﻿
检查 LogListener 心跳及配置
/etc/init.d/loglistenerd check
﻿
﻿
﻿
修改 LogListener 配置
请参见 LogListener 配置指南。
卸载 LogListener
1. 使用 停止命令 停止运行旧版本的 LogListener。
2. 以安装路径/usr/local/为例，在/usr/local/loglistener/tools路径下，以管理员权限执行卸载命令：
./loglistener.sh uninstall
手动更新 LogListener
复用断点文件（不会重复采集日志）
1. 使用 停止命令 停止运行旧版本的 LogListener。
2. 以安装目录/usr/local/loglistener为例，前往安装目录下，备份旧版本中的断点文件目录./data。例如：将旧版的断点文件备份至/tmp/loglistener-backup目录下。
cp -r ./data /tmp/loglistener-backup/
3. 使用 卸载命令 卸载旧版本的 LogListener。
4. ﻿下载并安装 最新版本的 LogListener，初始化 新版本 LogListener。
5. 以安装目录/usr/local/loglistener，复制所备份的断点文件目录（步骤2）到新版本 LogListener 目录下。
cp -r /tmp/loglistener-backup/data ./
6. 使用 启动命令 启动运行新版本 LogListener。
不复用断点文件（可能会重复采集日志）
1. 使用 停止命令 停止运行旧版本的 LogListener。
2. 使用 卸载命令 卸载旧版本的 LogListener。
3. ﻿下载并安装最新版本 的 LogListener，初始化 新版本 LogListener。
4. 使用 启动命令 启动运行新版本 LogListener。
﻿

LogListener 版本	处理器架构	操作系统类别	确定可安装环境
v2.x.x	x64/ARM	TencentOS Server	TencentOS Server 3.1、TencentOS Server 2.4
				CentOS（64位）	CentOS_6.8_64位、CentOS_6.9_64位、CentOS_7.2_64位、CentOS_7.3_64位、CentOS_7.4_64位、CentOS_7.5_64位、CentOS_7.6_64位、CentOS_8.0_64位
				Ubuntu（64位）	Ubuntu Server_14.04.1_LTS_64位、Ubuntu Server_16.04.1_LTS_64位、Ubuntu Server_18.04.1_LTS_64位、Ubuntu Server_20.04.1_LTS_64位、Ubuntu Server_22.04.1_LTS_64位、
				Debian（64位）	Debian_8.2_64位、Debian_9.0_64位
				openSUSE（64位）	openSUSE_42.3_64位

参数名	是否必填	类型描述
secretid	是	云 API 密钥的一部分，SecretId 用于标识 API 调用者身份。请确保云 API 密钥关联的账号具有相应的 LogListener 日志采集权限。
secretkey	是	云 API 密钥的一部分，SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥。请确保云 API 密钥关联的账号具有相应的 LogListener 日志采集权限。
encryption	否	是否对云API密钥进行加密存储。详情请参见密钥加密存储。
network	否	表示 LogListener 通过哪种方式访问服务域名，取值：intra 内网访问（默认），internet 外网访问。内网访问：适用于腾讯云服务器，且服务器所在地域与机器组一致。外网访问：适用于非腾讯云服务器，或服务器所在地域与机器组不一致。
region	若配置了 domain，该参数无需配置，否则必填	region 表示日志服务所在的地域，此处填写域名简称，例如 ap-beijing、ap-guangzhou 等。注意：当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请配置参数 network 为 internet，即代表外网访问。
domain	若配置了 region，该参数无需配置，否则必填	表示日志服务所在地域的域名。例如 ap-beijing.cls.tencentyun.com、ap-guangzhou.cls.tencentyun.com 等。注意：当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请配置外网域名。例如 ap-beijing.cls.tencentcs.com。
ip	否	机器的 IP 地址，机器组可通过所配 IP 地址与该机器关联，详情请参见机器组。若不填写，LogListener 会自动获取本机的 IP 地址。
label	否	机器标识，填写后该机器将与同样带有所填机器标识的机器组关联，详情请参见机器组。多个标识按逗号分隔。注意：若配置了机器标识，该机器将只能通过机器标识与机器组关联，无法通过 IP 进行关联；若不配置，机器组只能通过 IP 关联该机器。

LogListener 安装指南（Linux 版）

本页目录：

安装环境

支持功能

操作步骤

步骤1：下载安装 LogListener

步骤2：初始化 LogListener

参数说明

初始化成功返回样例

步骤3：启动 LogListener

步骤4：加入机器组

步骤5：采集日志

LogListener 常用操作

查看 LogListener 版本

查看 LogListener 帮助文档

停止 LogListener

重启 LogListener

查看 LogListener 进程状态

检查 LogListener 心跳及配置

修改 LogListener 配置

卸载 LogListener

手动更新 LogListener

复用断点文件（不会重复采集日志）

不复用断点文件（可能会重复采集日志）