Using the Automation Suite support bundle

Overview

Note:

You can get the Automation Suite Support Bundle tool in the following ways:

1. By unzipping the sf-installer.zip installer package.
2. By downloading the supportability-tools.zip

Before running the Automation Suite Support Bundle tool, navigate to the installer folder. You may find the installer in the following location or anywhere you downloaded it:

cd /opt/UiPathAutomationSuite/{version}/installer

To start using the Automation Suite Support Bundle tool, run the following command:

./Support-Tools/support-bundle/support-bundle.sh

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. To collect logs only for 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.
• 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.
• The RKE2, uipath, Redis, and Longhorn bundles are generated by default.
  • To disable the RKE2 bundle, run the support-bundle.sh -e command.
  • Long-running commands in the RKE bundle are disabled. To enable them, run the scripts/rke2-support-bundle.sh -a command.
  • To disable Redis bundle generation, run the support-bundle.sh -s command.

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.