租户端 存储 日志服务（CLS） 操作指南 LogListener安装指南

LogListener安装指南

最近更新时间: 2023-03-29 20:47:05

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 http://cls-loglistener-1255000003.cos.shjr.cos.financetcloud.cn/loglistener-linux-x64-2.8.2.tar.gz && tar -zxvf loglistener-linux-x64-2.8.2.tar.gz -C /usr/local && cd /usr/local/loglistener-2.8.2/tools && ./loglistener.sh install

2. 初始化 LogListener

在loglistener/tools路径下，以 root 权限执行 LogListener 初始化命令（默认使用内网方式访问服务），初始化命令如下：

./loglistener.sh init -secretid AKIDPEtPyKabfW8Z3Uspdz83xxxxxxxxxxx -secretkey whHwQfjdLnzzCE1jIf09xxxxxxxxxxxx -primary_region xxxxxx -host cls.api3.fincloud.tencent.cn -port 80

说明： 初始化命令中 -secretid、-secretkey、-primary_region为需要自主填写的参数，详细介绍请见如下 参数说明。

参数说明

参数名 类型描述
secretid 云 API 密钥 的一部分，SecretId 用于标识 API 调用者身份
secretkey 云 API 密钥 的一部分，SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥
primary_region primary_region 表示日志服务所在的地域
ip 机器的 ip 标识。若不填写，loglistener 会自动获取本机的 ip 地址
label 机器组标示，标示机器组需要填写标示信息，多个标示按逗号分隔

3. 启动 LogListener

成功安装后，执行 LogListener 启动命令：

/etc/init.d/loglistenerd start

LogListener 常用操作

说明：

本文档示例的操作命令说明仅适用于 LogListener-2.8.2 及以上版本，低版本操作命令请参见 低版本 LogListener 安装指南。

  1. 查看 LogListener 版本

    /etc/init.d/loglistenerd -v

  2. 查看 LogListener 帮助文档

    /etc/init.d/loglistenerd -h

  3. LogListener 进程管理

    /etc/init.d/loglistenerd (start|restart|stop) # 启动、重启、停止

  4. 查看 LogListener 进程状态

    /etc/init.d/loglistenerd status

    LogListener 正常情况会运行两个进程：

  5. 检查 LogListener 心跳及配置

    /etc/init.d/loglistenerd check

卸载 LogListener

以管理员权限执行 loglistener/tools 目录下的卸载命令：

./loglistener.sh uninstall

手动更新 LogListener

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

  1. 使用停止命令停止运行旧版本的 LogListener。

  2. 备份旧版本中的断点文件目录（loglistener/data）。例如，将旧版的断点文件备份至/tmp/loglistener-backup目录下。

    cp -r loglistener-2.8.2/data /tmp/loglistener-backup/

  3. 使用卸载命令卸载旧版本的 LogListener。

  4. 下载最新版本的 LogListener，并使用相关命令安装和初始化新版本 LogListener。

  5. 复制所备份的断点文件目录（步骤2）到新版本 LogListener 目录下。例如：

    cp -r /tmp/loglistener-backup/data loglistener-2.8.2/

  6. 使用启动命令启动运行新版本 LogListener。

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

  1. 使用停止命令停止运行旧版本的 LogListener。
  2. 使用卸载命令卸载旧版本的 LogListener。
  3. 下载最新版本的 LogListener，并使用相关命令安装和初始化新版本 LogListener。
  4. 使用启动命令启动运行新版本 LogListener。