Using the Automation Suite support bundle

Overview

Download the supportability-tools zip and extract its contents using the following commands:

curl "https://download.uipath.com/automation-suite/2021.10.6/supportability-tools-2021.10.6.zip" -o supportability-tools-2021.10.6.zip
unzip supportability-tools-2021.10.6.zip -d support-tools

You can generate the support bundle from the support-tools/support-bundle/ folder using the bash support-bundle.sh command. You can run the command from anywhere you have set the proper kubeconfig context to the cluster.

Note: In Azure, make sure your IP is added to the Network Security Group.

The following image shows a typical output for this command:

Automation Suite Support Bundle Parameters

• Running only bash support-bundle.sh collects logs for the last 2 days from Ceph, the S3-compatible in-cluster objectstore.
• To set the start date for the log collection process, use the -F argument and enter the date in the YYYY-MM-DD format. To set the number of days for which you want to collect logs, calculated from the start date, use the -D argument and enter the number of days as an integer. For example, to collect logs for the interval between July 20, 2024, and July 24, 2024, run bash support-bundle.sh -F 2024-07-20 -D 5.
  To collect logs for a particular date, use the -F argument to specify the date and the -D argument to set an interval of one day. For example, to collect logs for July 20, 2024, run bash support-bundle.sh -F 2024-07-20 -D 1.
  If you do not set the number of days for which you want to collect logs, the tool uses a default interval of 7 days, calculated from the start date. For example, running bash support-bundle.sh -F 2024-07-20 collects logs for the interval between July 20, 2024, and July 26, 2024.
• We collect logs for almost all the namespaces used in Automation Suite. If you want to collect logs for only particular namespaces, run bash support-bundle.sh -N uipath,uipath-infra. Use -N as list of namespaces for which you want to collect the logs.
• If you want to generate the support bundle for MongoDB, use -m at the end of the command (bash support-bundle.sh -m). This command generates a .tgz compressed file named mongo_support_bundle_<current_timestamp>.tgz under the same folder where the bash command is run. Attach this file and send it to UiPath Support Team.

Automation Suite Support Bundle Structure

The .zip archive contains following files and folders:

File/folder	Description
logs	Contains logs collected from the S3 store.
events	Contains event descriptions from all the namespaces.
nodes.info	Contains descriptions of all the nodes in the cluster.
jobs/deployments/pods/daemonsets	Contains descriptions of corresponding objects from all namespaces.
current-logs	Contains last 4 hour logs from currently running pods. We are collecting this to handle the scenario where Ceph S3 store is down.

If passed specific namespace list to the command, the structure would look similar to the one shown in the following image:

Browsing Through Logs

As we are providing a publicly downloadable link to the Automation Suite Support Bundle, you can download it on any machine and open it in any editor, such as VS Code, to use it.