Support Core Plugin

This plugin provides a common set of classes to assist in generating support bundles.

The plugin provides the basic infrastructure for generating "bundles" of support information within Jenkins.

There are three ways of generating bundles:

Docker File

As part of the support bundle if the About Jenkins option is checked then you will receive a docker file in the bundle also. The docker file contains the current version of Jenkins, along with a wget operation to download all of the plugins on the Jenkins master. This creates a similar environment for testing or reproducing bugs.

First build the image:

docker build -f Dockerfile

then run the docker image

docker run -d -p 8080:80

This should create a new Jenkins master with the same version, and the same plugins and versions all bundled.

Third party support providers

Various companies and organizations provide commercial support for Jenkins. They can provide additional content and branding to the support action. The following lists the known third party support providers (in date order) and the links to their support provider plugin.

Frequent issues

Support bundles corrupt through the UI

The most common situation for this to happen is when the About Jenkins option is enabled.

Meanwhile, the support bundle is getting generated it looks like the generation process is stuck as the downloaded size stays at the same point for a long time. To diagnosis this issue the best is to take a threadDump when in the moment where it is stuck and check the Jenkins logs.

If a stacktrace like the one below appears

"Handling POST /support/download from XX.XX.XX.XX : RequestHandlerThread[#126]" Id=123772 Group=main RUNNABLE
	at java.io.UnixFileSystem.getBooleanAttributes0(Native Method)
	at java.io.UnixFileSystem.getBooleanAttributes(UnixFileSystem.java:242)
	at java.io.File.isDirectory(File.java:849)
	at com.cloudbees.jenkins.support.impl.AboutJenkins$ItemsContent.printTo(AboutJenkins.java:641)
	at com.cloudbees.jenkins.support.api.PrintedContent.writeTo(PrintedContent.java:47)
	at com.cloudbees.jenkins.support.SupportPlugin.writeBundle(SupportPlugin.java:359)
	at com.cloudbees.jenkins.support.SupportAction.doDownload(SupportAction.java:154)

and the Jenkins logs are populated with 

2018-01-04 04:52:17.633+0000 [id=123769]	WARNING	c.c.j.support.SupportPlugin#writeBundle: Could not attach 'nodes/slave/Slave1/checksums.md5' to support bundle
org.eclipse.jetty.io.EofException: Closed
	at org.eclipse.jetty.server.HttpOutput.write(HttpOutput.java:476)
	at net.bull.javamelody.FilterServletOutputStream.write(FilterServletOutputStream.java:88)
	at net.bull.javamelody.CounterResponseStream.write(CounterResponseStream.java:82)
	at org.apache.tools.zip.ZipOutputStream.writeOut(ZipOutputStream.java:1029)
	at org.apache.tools.zip.ZipOutputStream.deflate(ZipOutputStream.java:680)
	at org.apache.tools.zip.ZipOutputStream.closeEntry(ZipOutputStream.java:432)
	at org.apache.tools.zip.ZipOutputStream.putNextEntry(ZipOutputStream.java:489)
	at com.cloudbees.jenkins.support.SupportPlugin.writeBundle(SupportPlugin.java:358)
	at com.cloudbees.jenkins.support.SupportAction.doDownload(SupportAction.java:154)

Then, surely the problem is that you are hitting the Idle timeout in the load balancer and this makes the connection betweek the ELB and your broweser to drop. To workaround this problem you can:

Support Bundle Anonymization

Beginning in version 2.48, this plugin now allows for automated ContentFilter extensions to enable anonymizing of various data. By enabling this feature, the default set of filters will anonymize agent names, agent computer names, agent labels, view names (aka folders), job names, usernames, and IP addresses (both IPv4 and IPv6). These data are mapped to randomly generated fake names which are saved to Jenkins master. A Jenkins administrator can view these mappings by going to Manage Jenkins › Support Bundle Anonymization. All files written to the support bundle by this and all extensions of this plugin will replace all instances of the original values with their anonymized counterpart. Note that the Stop Words list on that page shows which terms are ignored when filtering names (case-insensitive full match).



Anonymization filters only apply to text files. It cannot handle non-Jenkins URLs, custom proprietary Jenkins plugin names, and exceptions quoting invalid Groovy code in a Jenkins pipeline. The active plugins, disabled plugins, failed plugins, and Dockerfile reports are not anonymized due to several Jenkins plugins and other Java libraries using version numbers that are indistinguishable from IP addresses. These reports are in the files plugins/active.txtplugins/disabled.txtplugins/failed.txt, and docker/Dockerfile. These files should all be manually reviewed if you do not wish to disclose the names of custom proprietary plugins.

Version History

Version 2.54 (2019 Jan 15)

Version 2.53 (2018 Dec 11)

Version 2.53 (2018 Dec 11)

Version 2.52 (2018 Nov 28)

Version 2.51 (2018 Nov 19)

Version 2.50 (2018 Sept 13)

Version 2.49 (2018 Jul 19)

Version 2.48 (2018 Jul 02)

Version 2.47 (2018 Apr 19)

Version 2.46 (2018 Mar 14)

Version 2.45.1 (2018 Mar 09)

Version 2.45 (2018 Mar 07)

Version 2.44 (2017 Dec 12)

Version 2.43

Version 2.42

Version 2.41

Version 2.40

Version 2.39

Version 2.38

Version 2.37

Version 2.36

Version 2.35

Version 2.34

Version 2.33

Version 2.32

Version 2.31

Version 2.30

Version 2.29

Version 2.28

Version 2.27

Version 2.26 Bad release.

Version 2.25 (June 09 2015)

Version 2.24 (June 03 2015)

Version 2.23 (June 03 2015) (Bad release)

Version 2.22 (May 06 2015)

Version 2.21 (Apr 28 2014)

Version 2.20 (Dec 29 2014)

Version 2.19

No changelog recorded, blame Unknown User (kohsuke)!

Version 2.18 (Oct 30 2014)

Version 2.17 (Oct 10 2014)

Version 2.16 (Oct 8 2014)

Version 2.15 (Sept 25 2014)

Version 2.14 (Sept 5 2014)

Version 2.13 (Aug 26 2014)

Version 2.12 (Jul 22 2014)

Version 2.11 (Jul 8 2014)

Version 2.10 (Jul 8 2014)

Version 2.9 (Jul 8 2014)

Version 2.8 (Jul 8 2014)

Version 2.7 (Jul 4 2014)

Version 2.6 (May 19 2014)

Version 2.5 (May 12 2014)

Version 2.4 (May 06 2014)

Version 2.3 (April 23 2014)

Version 2.1 (Mar 24 2014)

Version 2.0 (Mar 20 2014)

Version 1.8 (Feb 05 2014)

Version 1.7 (Feb 04 2014)

Version 1.6 (Dec 02 2013)

Version 1.4 (Oct 24th, 2013)

Version 1.3 (Oct 24th, 2013)

Version 1.2 (Oct 24th, 2013)

Version 1.1 (Oct 24th, 2013)

Version 1.0 (Oct 24th, 2013)