Team Exasol
Team Exasol


Get debug information and log files from docker based systems


Access to host where is the docker container(s) running

How to get debug information

In order to get debug information and log files "exasupport" tool can be used. There is no installation required, the tool comes preinstalled with docker image

Step 1

Launch to launch a Bash terminal within a container:

docker exec -it {CONTAINER_NAME} bash

Step 2

"exasupport --help" command will return detailed information about the command

[root@n11 /]# exasupport --help
Usage: exasupport [options]

Retrieve support information

  -h, --help            show this help message and exit
  -d DEBUGINFO, --debug-info=DEBUGINFO
                        Debuginfo to retrieve, separated by comma: 1 =
                        EXAClusterOS logs, 2 = Coredumps, 3 = EXAStorage
                        metadata or 0 for all
  -s START_DATE, --start-time=START_DATE
                        Start time of logs (YYYY-MM-DD [HH:MM])
  -t STOP_DATE, --stop-time=STOP_DATE
                        Stop time of logs (YYYY-MM-DD [HH:MM])
                        EXASolution logs (System names, separated by comma or
                        "All databases")
                        EXASolution log type, separated by comma (1 = All, 2 =
                        SQL processes, 3 = Server processes)
  -i SESSION, --session=SESSION
                        Get logs from specific sessions, separated by comma
  -b BACKTRACES, --backtraces=BACKTRACES
                        Process backtraces 1 = EXASolution server processes, 2
                        = EXASolution SQL processes, 3 = EXAClusterOS
                        processes, 4 = ETL JDBC Jobs
  -n NODES, --nodes=NODES
                        Nodes (default: all online nodes)
  -a, --only-archives   Only download archives
  -f, --only-open-files
                        Only download open files
  -m, --estimate        Only estimate size of debug information
  -o OUTFILE, --outfile=OUTFILE
                        Output file

Step 3

An example to get all server processes and sql log file for specific session ID and date period you can use:

exasupport -d 0 -s 2020-10-25 -t 2020-10-26 -e {DATABASE_NAME} -x 1 -i {SESSION_ID}
If you don't know the database name you can use "dwad_client shortlist" command to get it.

Step 4

The command above will create a tar.gz file in /exa/tmp/support folder.

[root@n11 /]# exasupport -d 0 -s 2020-10-25 -t 2020-10-26 -e {DATABASE_NAME} -x 1 -i {SESSION_ID}
Successfully stored debug information into file /exa/tmp/support/exacluster_debuginfo_2020_10_26-11_20_01.tar.gz

[root@n11 /]# ls -lrt /exa/tmp/support/
total 492
-rwxr-xr-x 1 root root 503265 Oct 26 11:20 exacluster_debuginfo_2020_10_26-11_20_01.tar.gz
[root@n11 /]#

Step 4

You can access to this folder from the host system. If you used the article then all of your configuration and log files stored in $CONTAINER_EXA (/root/container_exa) folder.

root@host001:~# ls $CONTAINER_EXA/tmp/support/

Additional References