Generate a Support Bundle

Overview

When troubleshooting issues with Cisco Crosswork Assurance, Cisco Technical Assistance Center (TAC) may request a support bundle to help diagnose problems. A support bundle is a comprehensive collection of logs, system statuses, and configurations from your application.

To protect your environment, sensitive information such as secrets and credentials are automatically redacted before the bundle is generated.

When to Generate a Support Bundle

Generate a support bundle when:

• You encounter installation or upgrade failures
• The application is experiencing unexpected behavior or errors
• Pods are failing to start or restarting unexpectedly
• Cisco TAC requests diagnostic information for an open support case

Tip: Generate the support bundle as close to the time of the issue as possible. Logs rotate over time, so capturing data promptly ensures the most relevant information is included.

Prerequisites

Before generating a support bundle, ensure you have one of the following:

Creating a Support Bundle

There are three ways to create a support bundle. Choose the method that matches your access level.

Method 1: Via the Admin Console (Web UI)

1. Log in to the Admin Console in your web browser by visiting your machine's IP on port 30000 (e.g., https://10.128.0.1:30000).
2. Navigate to the Troubleshoot screen.
3. Press the Analyze Crosswork Assurance button. The system will generate the bundle for download.

Method 2: Via the Crosswork Assurance CLI

1. Log in to your machine via SSH.
2. Navigate to the directory where the application was installed.
3. Run the following command:

sudo ./provider-connectivity-assurance support-bundle

Method 3: Via kubectl support-bundle

1. Log in to your machine via SSH.
2. Enter the application shell:

sudo ./provider-connectivity-assurance shell

3. Run the command:

kubectl support-bundle

Note: You can optionally pass a YAML file provided by a Cisco support specialist to target specific data collection.

Sharing the Support Bundle with Cisco TAC

Once created, a support bundle is a single compressed file. You can share it with Cisco in the following ways:

• Directly as a File: Share the file via standard communication tools such as Webex or Email.
• Upload via Admin Console: From the Troubleshoot view in the Admin Console, you can download the file or press the upload button to send it directly to Cisco.
• Upload via Enterprise Portal: Log in to the Enterprise Portal, navigate to the Support page and select Upload a support bundle.