This topic is under construction for the 25.3 (March 2025) release. For the previous documentation of this feature, click here.
Site administrators can download a zip file bundling diagnostic information about their running LabKey Server. The contents of this file can help LabKey diagnose server configuration issues and better help you resolve them.
Download Diagnostic Information
To download the diagnostic zip file:
- Select > Site > Admin Console.
- On the Server Information tab, click Export Diagnostics.
- 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 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.
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.)
- labkey-audit.log
- labkey-indexed-documents.log
- labkeyMemory.log
Learn more about log files and roll-over in this topic:
Troubleshoot Installation and Configuration.
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.
Postgres Information
The contents of the pg_locks and pg_stat_admin views are included in tsv files. These views may provide insight when long running processes or queries block other database actions. Troubleshooters or site administrators can see this information from the Admin Console diagnostics links
Postgres Activity and Postgres Locks.
Server Information
The contents of
/labkey/admin-showAdmin.view are included in "server-info.txt". This is the information visible in the Admin Console, including what you see on the
Server Information tabs.
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.
Send Exported Diagnostics to LabKey
Once it has downloaded, you may be able to identify and resolve issues by reviewing the contents, but as part of your premium subscription, we're here to help.
- Navigate to your LabKey Support Portal.
- Click the LabKey logo in the upper left of this page to go to the home 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 bundle.
- Otherwise, open a new ticket, describe the issue you are having, and attach the diagnostic zip bundle to the ticket.
Related Topics
