LogListener Installation Guide

Last updated: 2021-05-12 17:45:12

    LogListener is a log collector provided by Cloud Log Service (CLS). You can install and deploy it on a server to collect logs quickly.

    Installation Environment

    LogListener supports only Linux 64-bit operating systems and does not support Windows now. It is compatible with mainstream Linux operating system versions. If LogListener is incompatible with the Linux operating system version you use, please submit a ticket.

    OS                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, CentOS_8.0_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
    openSUSE (64-bit) openSUSE_42.3_64-bit

    Installation and Startup

    1. Downloading and installing LogListener

    Download link of the latest version LogListener: Download LogListener.

    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.5.3.tar.gz && tar -zxvf loglistener-linux-x64-2.5.3.tar.gz -C /usr/local && cd /usr/local/loglistener-2.5.3/tools && ./loglistener.sh install
    

    2. Initializing LogListener

    In the loglistener/tools path, run the following command to initialize LogListener as the root user. By default, a private network is used to access the service:

    ./loglistener.sh init -secretid AKIDPEtPyKabfW8Z3Uspdz83xxxxxxxxxxx -secretkey whHwQfjdLnzzCE1jIf09xxxxxxxxxxxx -region ap-xxxxxx
    

    Note:

    You need to replace -secretid, -secretkey, -region, and -network in the command with the actual values. For more information, please see Parameter description below.

    Parameter description

    Parameter Description
    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 a region abbreviation here, such as ap-beijing or ap-guangzhou.
    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.
    ip Server IP. If this parameter is left empty, LogListener will automatically get the local IP address.
    label Server group tag, which is required if you want to identify the server group. Multiple tags should be separated by comma.

    A private network domain name is used by default:

    If you need to access the service by domain name through the public network, run the following command to set the network parameter internet explicitly:

    ./loglistener.sh init -secretid AKIDPEtPyKabfW8Z3Uspdz83xxxxxxxxxxxx -secretkey whHwQfjdLnzzCE1jIf0xxxxxxxxxxxx -region ap-xxxxxx -network internet
    

    Note:

    • It is recommended to use a collaborator key if the collaborator is granted the read and write permission of CLS by the root account.
    • region indicates the region of your CLS, instead of the region where your business server resides.
    • If your CVM instance and logset are in the same region, we recommend you access the service domain name over the private network; otherwise, use the public network.

    3. Starting LogListener

    After LogListener is successfully installed, run the following command to start it:

    /etc/init.d/loglistenerd start
    

    Common LogListener Operations

    Note:

    The operation commands used in this document are only applicable to LogListener-2.2.4 and later versions. For operation commands applicable to earlier versions, see Earlier-Version LogListener Installation Guide.

    1. Check LogListener version

    /etc/init.d/loglistenerd -v
    

    2. View LogListener help documentation

    /etc/init.d/loglistenerd -h
    

    3. Manage LogListener process

    /etc/init.d/loglistenerd (start|restart|stop) # Start, restart, stop
    

    4. Check LogListener process status

    /etc/init.d/loglistenerd status
    

    LogListener normally runs two processes:

    5. Check LogListener heartbeat and configuration

    /etc/init.d/loglistenerd check
    

    Uninstalling LogListener

    In the loglistener/tools directory, run the uninstallation command as the admin:

    ./loglistener.sh uninstall
    

    Manually Updating LogListener

    Breakpoint file reused (logs will not be repeatedly collected)

    1. Run the stop command to stop the existing LogListener.
    2. Back up the breakpoint file directory (loglistener/data) on the earlier version; for example, back up the legacy breakpoint file to the /tmp/loglistener-backup directory.
      cp -r loglistener-2.2.3/data /tmp/loglistener-backup/
      
    3. Run the uninstallation command to uninstall the existing LogListener.
    4. Download the latest version of LogListener and install and initialize it with relevant commands.
    5. Copy the breakpoint file directory backed up in step 2 to the new LogListener directory.
      cp -r /tmp/loglistener-backup/data loglistener-<version>/
      
      You can change the value of <version>. For example:
      cp -r /tmp/loglistener-backup/data loglistener-2.2.8/
      
    6. Run the start command to start the latest version of LogListener.

    Breakpoint file not reused (logs may be repeatedly collected)

    1. Run the stop command to stop the existing LogListener.
    2. Run the uninstallation command to uninstall the earlier version of LogListener.
    3. Download the latest version of LogListener and install and initialize it with relevant commands.
    4. Run the start command to start the latest version of LogListener.