LogListener 安装指南（Linux 版）

最近更新时间：2024-04-07 16:09:22

我的收藏

本页目录：

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位
?
?
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 AKIDPEtPyKabfW8Z3Uspdz83xxxxxxxxxxx -secretkey whHwQfjdLnzzCE1jIf09xxxxxxxxxxxx -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 操作指南。
1. 查看 LogListener 版本
/etc/init.d/loglistenerd -v
2. 查看 LogListener 帮助文档
/etc/init.d/loglistenerd -h
3. 停止 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
4. 重启 LogListener
通过systemd执行
不通过 systemd 执行
适用于 Loglistener 2.8.3以上并且操作系统具有 systemd。
systemctl restart loglistenerd
适用于 LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。
/etc/init.d/loglistenerd restart
5. 查看 LogListener 进程状态
/etc/init.d/loglistenerd status
LogListener 正常情况会运行两个进程：
?
?
6. 检查 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 使用流程下一篇: 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位
		?	?	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 关联该机器。