— This feature is available in the Professional, Professional Plus, and Enterprise Editions. Learn more
or contact LabKey
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
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.
Note: The size of the files included may be very large and take time to compress and download.
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.
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
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.)
These log files are stored in <CATALINA_HOME>/logs on your local machine. The $CATALINA_HOME environment variable points to the location of your tomcat installation
The contents of the Module Information
tab of the admin console, with each module node expanded to show details is included, plusthe contents of admin-modules.view
You can see this view in the admin console by selecting Module Information
and expanding each module node, then clicking Module Details
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.
A thread dump containing additional potentially useful information is also included. See Dump Memory and Thread Usage 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.