LogListener is a log collector provided by Tencent Cloud Log Service (CLS). You can install and deploy it on a server to collect logs quickly.
LogListener supports only Linux 64-bit operating systems but not Windows for the moment. It is compatible with mainstream Linux distributions. If it is incompatible with the Linux distribution you use, please submit a ticket for assistance.
|Operating System||Compatible Versions|
|CentOS (64-bit)||CentOS_6.8_64-bit, CentOS_6.9_64-bit, CentOS_7.2_64-bit, CentOS_7.3_64-bit, CentOS_7.4_64-bit, CentOS_7.5_64-bit, CentOS_7.6_64-bit|
|Ubuntu (64-bit)||Ubuntu Server_14.04.1_LTS_64-bit, Ubuntu Server_16.04.1_LTS_64-bit, Ubuntu Server_18.04.1_LTS_64-bit|
|Debian (64-bit)||Debian_8.2_64-bit, Debian_9.0_64-bit|
Download the latest version of LogListener here.
Download the LogListener installation package and decompress it to the installation path (
/usr/local/ in this example). Then go to the LogListener directory
loglistener/tools and run the following installation command:
wget https://loglistener-1254077820.cos.ap-shanghai.myqcloud.com/loglistener-linux-x64-2.3.6.tar.gz && tar -zxvf loglistener-linux-x64-2.3.6.tar.gz -C /usr/local && cd /usr/local/loglistener-2.3.6/tools && ./loglistener.sh install
loglistener/tools path, run the following command to initialize LogListener as the root user (by default, the private network is used to access the service):
./loglistener.sh init -secretid AKIDPEtPyKabfW8Z3Uspdz83xxxxxxxxxxx -secretkey whHwQfjdLnzzCE1jIf09xxxxxxxxxxxx -region ap-xxxxxx
You need to replace -secretid, -secretkey, -region, and -network in the commands with the actual values. For more information, see parameter description below.
|secretid||Part of a TencentCloud API key, which is used to identify the API requester|
|secretkey||Part of a TencentCloud API key, which is used to encrypt the strings to create a signature so that Tencent Cloud server can validate the identity of the requester|
|region||Region where CLS resides. Enter the region abbreviation, such as
|network||Type of the network through which LogListener accesses the service by domain name. Valid values: intra (private network), internet (public network). Default value: intra.|
A private domain name is used by default:
If you need to access the service by domain name over a public network, run the following command to set the network parameter
./loglistener.sh init -secretid AKIDPEtPyKabfW8Z3Uspdz83xxxxxxxxxxxx -secretkey whHwQfjdLnzzCE1jIf0xxxxxxxxxxxx -region ap-xxxxxx -network internet
- We recommend that you use a collaborator key, and have the collaborator assigned with the CLS read/write permission by the root account.
regionparameter indicates the region of the CLS you use, instead of the region where your business server resides.
- If your CVM instance and logset are in the same region, we recommend that you access the service by domain name over a private network. Otherwise, use the public network.
After LogListener is successfully installed, run the following command to start it:
The operation commands used in this document are only applicable to LogListener-2.2.4 and later versions. If you use an earlier version, see Operation Guide of Earlier LogListener Versions.
/etc/init.d/loglistenerd (start|restart|stop) # start, restart and stop LogListener
LogListener normally runs two processes:
###5. Checking LogListener heartbeat and configuration
loglistener/tools directory, run the uninstallation command as the root user:
loglistener/data) on the earlier version; for example, back up the legacy breakpoint file to the
cp -r loglistener-2.2.3/data /tmp/loglistener-backup/
cp -r /tmp/loglistener-backup/data loglistener-2.2.8/