Backtrace Information

If you are experiencing performance problems or hanging operations, you need to provide support with all the backtrace information for the time period that the problem occurred.

Make sure you have enough free disk space for the log. For more information, see EXAsupport.


There are no prerequisites for this procedure.


The ConfD examples are written in Bash on a Linux terminal running the Exasol tool confd_client, which is accessed by connecting to EXAClusterOS on the database nodes using Exasol Deployment Tool (c4). You can also interact with ConfD from an external tool using Python and XML-RPC. For more information, see ConfD.

Placeholder values are indicated with UPPERCASE characters. Replace the placeholders with your own values.

  1. Connect to EXAClusterOS (COS) using c4 connect -t<DEPLOYMENT>/cos. For example:

    c4 connect -t1/cos

    If you do not specify a node, you will normally be connected to the first node in the deployment. If the cluster is configured with an access node, the first node is the access node (usually n10). The COS command prompt indicates which node you are currently connected to.

    [root@n10 ~]#

    For more information about c4 commands, see Exasol Deployment Tool (c4).

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

    confd_client -c db_list
  3. To create a backtrace log, use the EXAsupport command-line tool (exasupport) . Specify the start date (-s) and end date (-t) using the format YYYY-MM-DD.


    exasupport -s 2022-08-11 -t 2022-08-11 -e DB_NAME -b1,2,3,4

    If the log file was created successfully, 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. To disconnect from EXAClusterOS, use CTRL+D or type exit.
  5. Copy the log file to your local computer using the scp command (secure copy).

    scp -P $COS_PORT -i ~/.ssh/$KEY root@$DATABASE_IP:/exa/tmp/support/$FILENAME $LOCAL_FOLDER
    Parameter Description

    The SSH port for connecting to EXAClusterOS (COS). Default = 20002

    To find the port number in the configuration, use c4 config | grep CCC_PLAY_SSHD_PORT.


    The filename of the SSH private key.

    To find the filename in the configuration, use c4 config | grep CCC_AWS_KEY_PAIR_FILE.


    The external IP address of the cluster node that you were connected to when creating the log file.

    To find the IP addresses of all nodes, use c4 ps.

    $FILENAME The name of the log file that was generated by exasupport in the previous step.
    $LOCAL_FOLDER Path to a folder on your computer where the log file will be stored.


    Get the necessary info:

    c4 config | grep CCC_AWS_KEY_PAIR_FILE

    c4 config | grep CCC_PLAY_SSHD_PORT

    c4 ps 
      ┌─  1  3a4a7d8d  10    awscf   c5d.large    c      running    04:35:15  +∞
      │   1  3a4a7d8d  11    awscf   c5d.2xlarge    d      running    04:35:16  +∞
      └─  1  3a4a7d8d  12    awscf   c5d.2xlarge    d      running    04:35:15  +∞

    Copy the file to your local machine:

    scp -P 2002 -i ~/.ssh/my_private_key.pem \
      root@ ~/my_logs/


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


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