Support & Diagnostics

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.

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.

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
Generating a Support Bundle in Develocity UI

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 to generate a support bundle by running the following command in your terminal:

  • develocityctl JAR

  • develocityctl Docker image

# Using the develocityctl JAR
java -jar develocityctl.jar --kube-ns=develocity support-bundle
# 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

Generation can take several minutes depending on the size of your logs and database statistics.

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.

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.

Submitting a Support Request

Once you have gathered your diagnostic data:

  1. Navigate to the Gradle Support Portal.

  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.