安装指南

LogListener 是腾讯云日志服务 CLS 所提供的日志采集客户端，将它安装部署到目标机器上，可以实时快速地采集日志。

支持环境

目前，LogListener 支持如下版本的 Linux 64 位操作系统：

• CentOS
• Debian
• SUSE
• OpenSUSE
• Ubuntu

安装步骤

1. 下载并解压 LogListener

LogListener 最新版本下载地址如下： 下载 LogListener。

此次以解压路径/usr/local/为例：
下载 LogListener，并解压下载的安装包，解压路径为/usr/local/ ，解压完成后进入 LogListener 安装目录/loglistener/tools 。该示例命令如下：

wget https://loglistener-1254077820.cos.ap-shanghai.myqcloud.com/loglistener.2.2.3.tar.gz && tar -zxvf loglistener.2.2.3.tar.gz -C /usr/local/ && cd /usr/local/loglistener/tools

2. 安装 LogListener

以 sudo 权限执行以下命令，安装 LogListener：

./install.sh [SecretId] [SecretKey] [region]

参数示例：

./install.sh AKIDc9YlmrBcFk4C8sbmXQ8i65XXXXXXXXXX LUSE4nPK1d4tX5SHyXv6tZXXXXXXXXXX ap-guangzhou 

说明：

• 建议使用协作者密钥，需要主账号授权协作者于日志服务的读写权限。
• region 为您所使用的日志服务区域而非您的业务机器所处的区域。

操作 LogListener

启动 LogListener

您可以通过以下脚本启动 LogListener：

cd /usr/local/loglistener/tools; ./start.sh

停止 LogListener

您可以通过以下脚本停止 LogListener：

cd /usr/local/loglistener/tools; ./stop.sh

查看进程

您可以通过以下命令查看 LogListener 进程：

cd /usr/local/loglistener/tools; ./p.sh

正常情况下，将存在以下三个进程：

bin/loglistenerm -d                                #守护进程
bin/loglistener --conf=etc/loglistener.conf        #主进程    
bin/loglisteneru -u --conf=etc/loglistener.conf    #更新进程

卸载 LogListener

您可以通过以下命令卸载 LogListener：

cd /usr/local/loglistener/tools; ./uninstall.sh

注意：

卸载操作将删除 rc.local里自动重启的工具。

更新 LogListener

若您的 LogListener 版本非当前最新版本，我们建议您更新至最新版本。低于 2.2.2 版本的 LogListener 不支持完全正则采集。您可以在loglistener/version.txt中查看当前 LogListener 的版本信息。

• LogListener 版本高于2.0.0，但低于2.2.2，更新步骤如下 ：
  1. 下载新的安装包。
  2. 在安装目录（LogListener平级目录）解压新的压缩包。
  3. 解压后重启 LogListener 即完成更新操作。
• LogListener 版本低于2.0.0， 手动更新步骤如下：
  1. 停止较低版本 LogListener。
  2. 备份较低版本 LogListener。
  3. 下载并安装最新版本 LogListener。