LogListener 是腾讯云日志服务 CLS 所提供的专用日志采集器，将它安装部署到服务器上，可快速采集日志到日志服务。
安装环境
LogListener 仅支持64位 Linux 操作系统环境（暂不支持 Windows），并适配主流 Linux 操作系统版本，若其他版本环境若安装异常，请 提交工单 联系我们。
| 操作系统类别 | 确定可安装环境 |
|---|---|
| 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位 |
| 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位 |
安装启动
1. 下载安装 LogListener
LogListener 最新版本下载地址： 下载 LogListener
以安装路径/usr/local/为例： 下载 LogListener 安装包并解压，解压路径为/usr/local/ ，解压完成后进入 LogListener 目录loglistener/tools，执行安装命令 。该操作命令如下：
wget https://loglistener-1254077820.cos.ap-shanghai.myqcloud.com/loglistener-linux-x64-2.3.9.tar.gz && tar -zxvf loglistener-linux-x64-2.3.9.tar.gz -C /usr/local && cd /usr/local/loglistener-2.3.9/tools && ./loglistener.sh install2. 初始化 LogListener
在loglistener/tools路径下，以 root 权限执行 LogListener 初始化命令（默认使用内网方式访问服务），初始化命令如下：
./loglistener.sh init -secretid AKIDPEtPyKabfW8Z3Uspdz83xxxxxxxxxxx -secretkey whHwQfjdLnzzCE1jIf09xxxxxxxxxxxx -region ap-xxxxxx说明：初始化命令中 -secretid、-secretkey、-region、-network 为需要自主填写的参数，详细介绍请见如下 参数说明。
参数说明
| 参数名 | 类型描述 |
|---|---|
| secretid | 云 API 密钥 的一部分，SecretId 用于标识 API 调用者身份 |
| secretkey | 云 API 密钥 的一部分，SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥 |
| region | region 表示日志服务所在的 地域，此处填写域名简称，例如 ap-beijing、ap-guangzhou 等 |
| network | 表示 loglistener 通过哪种方式访问服务域名，取值：intra 内网访问（默认），internet 外网访问 |
| ip | 机器组 ip，不填默认本机 ip |
| label | 机器组标示，标示机器组需要填写标示信息，多个标示按逗号分隔 |
默认使用内网域名：
如果需要通过外网方式访问服务域名，需要显式设置网络参数internet，执行如下命令：
./loglistener.sh init -secretid AKIDPEtPyKabfW8Z3Uspdz83xxxxxxxxxxxx -secretkey whHwQfjdLnzzCE1jIf0xxxxxxxxxxxx -region ap-xxxxxx -network internet
说明：
- 建议使用协作者密钥，需要主账号授权协作者于日志服务的读写权限。
- region 为您所使用的日志服务区域，而非您的业务机器所处的区域。
- 云服务器与日志集同地域的情况下，建议使用内网方式访问服务域名。云服务器与日志集在不同地域的情况下，建议使用外网方式访问服务域名。
3. 启动 LogListener
成功安装后，执行 LogListener 启动命令：
/etc/init.d/loglistenerd start
LogListener 常用操作
说明：本文档示例的操作命令说明仅适用于 LogListener-2.2.4 及以上版本，低版本操作命令请参见 低版本 LogListener 安装指南。
1. 查看 LogListener 版本
/etc/init.d/loglistenerd -v2. 查看 LogListener 帮助文档
/etc/init.d/loglistenerd -h3. LogListener 进程管理
/etc/init.d/loglistenerd (start|restart|stop) # 启动、重启、停止4. 查看 LogListener 进程状态
/etc/init.d/loglistenerd statusLogListener 正常情况会运行两个进程：
5. 检查 LogListener 心跳及配置
/etc/init.d/loglistenerd check
卸载 LogListener
以管理员权限执行 loglistener/tools 目录下的卸载命令：
./loglistener.sh uninstall手动更新 LogListener
复用断点文件（不会重复采集日志）：
- 使用停止命令停止运行旧版本的 LogListener。
- 备份旧版本中的断点文件目录（
loglistener/data）。例如，将旧版的断点文件备份至/tmp/loglistener-backup目录下。
cp -r loglistener-2.2.3/data /tmp/loglistener-backup/- 使用卸载命令卸载旧版本的 LogListener。
- 下载最新版本的 LogListener，并使用相关命令安装和初始化新版本 LogListener。
- 复制所备份的断点文件目录（步骤2）到新版本 LogListener 目录下。例如：
cp -r /tmp/loglistener-backup/data loglistener-2.2.8/- 使用启动命令启动运行新版本 LogListener。
不复用断点文件（可能会重复采集日志）：
- 使用停止命令停止运行旧版本的 LogListener。
- 使用卸载命令卸载旧版本的 LogListener。
- 下载最新版本的 LogListener，并使用相关命令安装和初始化新版本 LogListener。
- 使用启动命令启动运行新版本 LogListener。
