Cluster Logs

This article explains how to generate cluster logs on your Exasol system.

If you are experiencing general issues with the cluster operating system (COS), you need to provide a cluster log.

Prerequisites

You must have enough free disk space for the logs. For more information, see EXAsupport.

Procedure

The following examples use the c4 and confd_client command-line tools in a Linux terminal. For more information about these tools, see Exasol Deployment Tool (c4) and ConfD.

  1. Connect to the cluster operating system (COS) using c4 connect -i PLAY_ID -s cos. For example:

    ./c4 connect -i c3275f84 -s cos

    For more information about how to use c4 connect, see How to use c4.

  2. To find the name of the database, use the ConfD job db_list. For example:

    confd_client db_list
    - MY_DATABASE

  3. To create a cluster log, use the EXAsupport tool . Specify the start date (-s) and end date (-t) using the format YYYY-MM-DD. For example:

    exasupport -d1 -s 2022-08-11 -t 2022-08-11 -e MY_DATABASE -x3

    If the log file was successfully created, you will see the following message containing the file name:

    Successfully stored debug information into file /exa/tmp/support/exacluster_debuginfo_2022_08_11-23_27_20.tar.gz

  4. Use Control+D or type exit to disconnect from COS.

  5. Copy the log file to your local computer by connecting to COS and using the cat command:

    ./c4 connect -t <DEPLOYMENT>.<NODE>/cos -- "cat /exa/tmp/support/$FILENAME" > $FILENAME
    Example:
    ./c4 connect -t 1.11/cos -- "cat /exa/tmp/support/my_log" > my_log

Verification

To verify that the log was successfully copied, use the ls command in the target folder on your local machine.

Example:
ls -lahtr ~/mylogs | grep exacluster_debuginfo
-rwxr-xr-x  1 user group 9.8K Sep 20 17:38 exacluster_debuginfo_2022_08_11-23_27_20.tar.gz