Since GitHub Enterprise Support does not have access to your environment, we require some additional information from you.
Support Bundle
The Support Bundle is a gzip-compressed tar archive that contains important logs from your instance:
-
github-logs/auth.log
- Authentication-related errors that may be helpful when configuring LDAP, CAS, or SAML. -
github-logs/exceptions.log
- Information about 500 errors encountered on the site. -
enterprise-manage/unicorn.log
- Information about 500 errors encountered in the Management Console.
There are two ways to retrieve your Support Bundle:
Download from the Management Console
- Go to
https://[hostname]/setup/support
. - Click Download support bundle.
Download from the command line
To download your Support Bundle from the command line, run the following command from your local machine:
ssh -p122 admin@host -- 'ghe-support-bundle -o' > support-bundle.tgz
When you contact GitHub Enterprise Support, you'll be sent a confirmation email that will contain a ticket reference link where you can upload the support bundle.
For more details about the ghe-support-bundle
command, see the Command-line utilities documentation.
Uploading from the command line
You can also upload the bundle directly to support with the -u
flag:
ssh -p122 admin@host -- 'ghe-support-bundle -u'
Obtaining an extended bundle
To prevent bundles from getting too large, they only contain logs that have not been rotated and compressed. Log rotation on GitHub Enterprise happens at various frequencies (daily or weekly) for different log files, depending on how large we expect the logs to be. If you need access to the older compressed logs, you can generate an extended support bundle from the command line on your local machine with the following command:
ssh -p122 admin@[hostname] -- 'ghe-support-bundle -x -o' > support-bundle.tgz
Extended bundles can only be downloaded from the command line.
Diagnostics
Diagnostics are an overview of a GitHub Enterprise instance's settings and environment that contains:
- Client license information, including company name, expiry date, and number of seats
- Version numbers and SHAs
- VM architecture
- Host name, privacy mode, SSL settings
- Load and process listings
- Network settings
- Authentication method and details
- Number of repositories, users, and other installation data
There are two ways to retrieve your diagnostics:
Download from the Management Console
This method is convenient when you don't have your SSH key readily available.
- Go to
https://[hostname]/setup/diagnostics
. - Click Download diagnostics.
Run the command-line utility
Use the ghe-diagnostics command-line utility to retrieve the diagnostics for your instance. This method allows you to skip signing in to the Management Console.
ssh -p122 admin@[hostname] -- 'ghe-diagnostics' > diagnostics.txt