Site administrators can download a zip file bundling diagnostic information about their running LabKey Server. The contents of this file can help LabKey Client Services diagnose server configuration issues and better help you resolve them.

• Downloading Diagnostic Information
• Diagnostic Zip File Contents
• Using the Exported Diagnostics

Downloading Diagnostic Information

To download the diagnostic zip file:

• Select (Admin) > Site > Admin Console.
• Click Export Diagnostics under "Server Information".

• If you do not see this link, you are not running a premium edition of LabKey Server.
• Click Download.

The LabKey diagnostic zip file will now download automatically.

• Learn more about what is included in the archive
• Learn how to report these diagnostics to LabKey

Depending on your browser and settings, you may find the downloaded archive is visible on a toolbar at the top or bottom of your browser, or it may be located in a "Downloads" directory on the local machine.

Diagnostic Zip File Contents

LabKey takes your privacy very seriously. In order to serve you better, this file contains detailed information, like log files, that go beyond what is provided in the Admin Console UI. Passwords and other sensitive information are always removed to protect your privacy.

The following information is included in the archive.

Server Information

The contents of /labkey/admin-showAdmin.view. This is the information visible in the Admin Console UI. Including what you see on the Server Information tabs.

Log Files

Several sets of log files are included in the archive:

• labkey.log, plus any rolled-over log files (labkey.log.1, etc.)
• labkey-error.log, plus any rolled-over log files (labkey-error.log.1, etc.)
• catalina.out

Module Information

The contents of the Module Information tab of the admin console, with each module node expanded to show details is included, plus the contents of admin-modules.view.

You can see this view in the admin console by selecting Module Information and expanding each module node. A grid of all modules is available by clicking Module Details.

Usage Metrics

Some modules may post key/value pairs of diagnostic information for use in these reports. These diagnostic metrics will be included in the zip file, but will not be reported to mothership, the exception reporting service built into LabKey.

Thread Dump

A thread dump containing additional potentially useful information is also included. See Collect Debugging Information for more detail.

Using the Exported Diagnostics

Once it has downloaded:

• Navigate to your LabKey Support Portal.
• Click the LabKey logo in the upper left of this page.
• Log in if necessary to see your list of project portals.
• Click the icon to open the project portal.

• Click Support Tickets.
• If you already opened a support ticket regarding this issue, find it and use Update to add the downloaded zip file.
• Otherwise, open a new ticket, describe the issue you are having, and attach the diagnostic file to the ticket.

Related Topics

• Admin Console
• Diagnostics
• Collect Debugging Information