---
component: ROOT
version: "2026.1"
slug: ROOT/operations/support-and-diagnostics
canonical_url: "https://docs.gradle.com/develocity/2026.1/operations/support-and-diagnostics/"
title: "Support and Diagnostics"
description: "Generate support bundles and Build Scan dumps to assist in troubleshooting Develocity issues."
keywords: []
status: current
---

<!-- llms-index: https://docs.gradle.com/develocity/llms.txt -->

# Support and Diagnostics

<a id="preamble"></a>

When troubleshooting technical issues, Gradle Support may request diagnostic data to identify root causes.

Develocity provides two primary diagnostic tools:

*   **Support Bundles** for system-wide health.
    
*   **Build Scan Dumps** for issues related to a specific build.
    

<a id="support-bundle"></a>

## Support Bundle

A support bundle is a comprehensive package containing server logs, system performance metrics, and database statistics. It provides our engineers with a "snapshot" of your installation’s health.

<a id="generate-via-the-user-interface"></a>

### Generate via the User Interface

This is the recommended method for most troubleshooting scenarios.

1.  Log in to Develocity as a user with the **Generate support bundles** permission.
    
2.  Navigate to **Administration**  **Support**.
    
3.  Decide whether to select a custom time range or include all available data.
    
4.  Decide whether to include proxy-access logs (if applicable).
    
5.  Decide whether to disable metrics data collection during bundle generation to reduce the bundle size.
    
6.  Click **Generate support bundle**.
    
7.  Wait for the progress bar to complete. Your browser will automatically download the `.zip` archive.
    

![Generating a Support Bundle in Develocity UI](https://docs.gradle.com/develocity/2026.1/operations/support-and-diagnostics/../_images/dv-ui-support-bundle.png)

Generating a Support Bundle in Develocity UI

<a id="generate-via-the-develocity-cli"></a>

### Generate via the Develocity CLI

If the Develocity user interface is unavailable or unresponsive, you can generate the bundle directly from the command line.

Use the [develocityctl](https://docs.gradle.com/develocity/develocityctl/1.22/) to generate a support bundle by running the following command in your terminal:

<a id="tabs-1"></a>

*   <a id="tabs-1-develocityctl-jar"></a>
    
    develocityctl JAR
    
*   <a id="tabs-1-develocityctl-docker-image"></a>
    
    develocityctl Docker image
    

<a id="tabs-1-develocityctl-jar--panel"></a>

```shell
# Using the develocityctl JAR
java -jar develocityctl.jar --kube-ns=develocity support-bundle
```

<a id="tabs-1-develocityctl-docker-image--panel"></a>

```shell
# Using the develocityctl Docker image
docker run --rm -it \
  -v "${HOME}/.kube/config:/kube-config:ro" \
  -v "${HOME}/bundles:/home" \
  gradle/develocityctl --kube-ns=develocity support-bundle
```

> [!NOTE]
> Generation can take several minutes depending on the size of your logs and database statistics.

* * *

<a id="build-scan-dumps"></a>

## Build Scan Dumps

If you are experiencing an issue with a specific build (e.g., missing data or incorrect visualization), you can provide a dump of just that individual Build Scan.

<a id="how-to-generate-a-dump"></a>

### How to Generate a Dump

There is no button for this in the UI; it’s performed by modifying the Build Scan URL.

1.  Open the Build Scan you wish to investigate in your browser.
    
2.  In the address bar, replace `/s/` with `/scan-dump/`.
    
    *   **Original:** `https://develocity.example.com/s/fmhyzs45gaepw`
        
    *   **Modified:** `https://develocity.example.com/scan-dump/fmhyzs45gaepw`
        
    
3.  Press Enter. The browser will automatically download a `.scandump` file.
    

* * *

<a id="submitting-a-support-request"></a>

## Submitting a Support Request

Once you have gathered your diagnostic data:

1.  Navigate to the [Gradle Support Portal](http://support.gradle.com).
    
2.  Open a new support ticket.
    
3.  Attach your `.zip` support bundle or `.scandump` file.
    
4.  Provide a detailed description of the symptoms and the time the issue occurred.
    

* * *

<a id="related-tasks"></a>

## Related Tasks

*   [Managing Support Permissions](https://docs.gradle.com/develocity/2026.1/administration/access-control/permissions-and-roles/)