Last updated: 2019-10-30 17:07:37PDF
LogListener is a log collection client provided by Tencent Cloud's Cloud Log Service (CLS). You can install and deploy it on the target server to collect logs quickly and in real time.
LogListener supports the following Linux 64-bit operating systems:
1. Downloading LogListener
The download address of the latest version of LogListener is as follows: Download LogListener.
2. Installing LogListener
Decompress the downloaded installer package. The installation decompression path is
/usr/local/. Execute the commands as follows:
tar -zxvf [Installer package] -C /usr/local/ && cd /usr/local/loglistener/tools
Enter the installation directory of LogListener
/loglistener/tools, and execute the following commands with root permission:
./install.sh [SecretId] [SecretKey] [region]
./install.sh AKIDc9YlmrBcFk4C8sbmXQ8i65XXXXXXXXXX LUSE4nPK1d4tX5SHyXv6tZXXXXXXXXXX ap-guangzhou
|Parameter Name||Type Description|
|SecretId||Part of the Cloud API key, which is used to identify the API caller|
|SecretKey||Part of the Cloud API key, which is used to encrypt signature strings and verify server-side signature strings|
|region||Region of the log service|
- It is recommended to use a collaborator key, and the collaborator should be granted the read-write permission of CLS by the root account.
- The field "region" is where CLS is available instead of the region in which your business server resides.
- The installation script uses
rc.localto ensure that the client starts normally upon server restart.
Working with LogListener
You can launch the LogListener by running the following script:
cd /usr/local/loglistener/tools; ./start.sh
You can stop the LogListener by running the following script:
cd /usr/local/loglistener/tools; ./stop.sh
Viewing the Processes
You can view the processes of LogListener using the following command:
cd /usr/local/loglistener/tools; ./p.sh
Normally, there are three processes:
bin/loglistenerm -d # Daemon bin/loglistener --conf=etc/loglistener.conf # Main process bin/loglisteneru -u --conf=etc/loglistener.conf # Update process
You can uninstall the LogListener using the following command:
cd /usr/local/loglistener/tools; ./uninstall.sh
Uninstalling LogListener deletes the auto-restart tool from
We recommend that you update LogListener to the latest version. Full RegEx collection is not supported for LogListner of versions earlier than 2.2.2. You can view the LogListener version information in
- If your LogListener version is later than 2.0.0 but earlier than 2.2.2, the following updating procedures apply:
- Download a new installer package.
- Decompress the new compressed package to the installation directory (the same level as the directory of LogListener).
- After the decompression, restart LogListener to complete the update process.
- If your LogListener version is earlier than 2.0.0, update it manually by following the procedures below:
- Stop the earlier version of LogListener.
- Back up the earlier version of LogListener.
- Download and install the latest LogListener.