Premium Feature — 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.

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
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.

Module Information

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.

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 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.

Related Topics

Discussion

Was this content helpful?

Log in or register an account to provide feedback


previousnext
 
expand all collapse all