Create a Support Zip
If you're having problems with an Atlassian application, it can be useful to create a support zip for the Atlassian Support Team, which contains logs from your instance, and diagnostic and configuration information. Support zips help Atlassian Support understand how your application has been configured and troubleshoot your problem. Providing a support zip is completely optional, but it does provide a great deal of useful information for Atlassian Support.
The Atlassian Troubleshooting and support tools plugin simplifies the process of gathering your log and configuration files. It sanitizes any usernames and passwords it finds in your configuration files, but does not sanitise usernames and content present in the log files. The plugin is bundled with all Atlassian products, and can also be downloaded from the Atlassian Marketplace.
Creating a support zip
Troubleshooting and support tools can be found in your application's administration console. You'll need to be logged in as an Administrator to use it.
- For Bamboo go to > Overview > Support Tools (under System)
- For Bitbucket go to > Administration > Troubleshooting and support tools (under Support)
- For Confluence go to > General Configuration > Troubleshooting and support tools (under Administration)
- For Crowd (2.11 and later) go to > Support Tools
- For FishEye / Crucible go to > Administration > Support Tools (under System Settings)
- For JIRA applications go to > System > Troubleshooting and support tools (under System support)
To create a support zip, go to the Create support zip tab. Refer to the table below to find out what each option contains.
In this table 'application' refers to the name of your application, for example Confluence.
|Option||Where is it in the Support Zip?||What does it contain?|
In some cases, the thread dumps generated by the Support Tools plugin may not show all of the required information. Support may ask you to generate thread dumps externally if more information is required.
|Application Configuration Files||
Application configuration files - such as
|Health check results||
||Lists every health check and current results for your instance.|
|Tomcat Configuration Files||
||Configuration for Tomcat, including the application's
||Configuration of user directories in your application. Some applications may also include a Directory Configuration Summary.|
||Configuration for caching in your application. It may be omitted if your application does not provide this information.|
||Logs generated from the application itself. Diagnostic information will also be generally logged to this location.|
||Logs generated from the Tomcat container, including
|Limit File Sizes||If this option is ticked, the support zip will not include any file that is larger than 25MB. This can be useful on systems that have customised logging. Note that the size of the support zip may exceed 25MB; this only applies to which files are included.|