Downloading System Logs

Last modified on September 18, 2023

This information applies to SwaggerHub On-Premise.

SwaggerHub On-Premise keeps system logs for troubleshooting purposes. The logs include error and debug messages, system information, configuration settings, and other diagnostic data that can be useful to troubleshoot issues with your SwaggerHub On-Premise instance. When you contact SmartBear Support, you may be asked to provide the logs.

Download the logs

  1. Log in to the Admin Center.

  2. Switch to the System tab.

  3. Click Download Diagnostic Data (or Download Logs in older versions).

Logs are downloaded in a ZIP file.

Log files

In SwaggerHub On-Premise versions up to 1.18.8, the logs are encrypted and can only be decrypted by the SmartBear Support team. Please send the logs as is to Support.

Since SwaggerHub On-Premise 1.19.1, the logs are in plain text, and you can review them yourself. The available log files are:

File name Description
api-service.log User Management API log. Available since v. 1.26.
config.json SwaggerHub On-Premise configuration settings, including the hostname, authentication method, SAML or LDAP configuration, and so on. This is the information from the Settings page of the Admin Center. Passwords are masked.
custom-rules.log The processing log of custom standardization rules, including the titles and versions of the APIs being processed by each rule. Available since v. 1.28.
history.json The history of system upgrades.
installer.log The installation and startup log.
licenseInfo.json Contains the license information, including the company name, plan limits, and license expiration date.
proxy.log HAProxy Docker image log. In particular, this log contains errors related to the SSL certificate and private key installed on your SwaggerHub instance (when SSL is terminated on SwaggerHub).
serviceStates.json Contains the version and status of SwaggerHub system components. This is the information from the System Status page of the Admin Center.

swaggerhub.json

The main SwaggerHub application log for the last 7 days. Log data is a JSON array where each element (log entry) has the format like this:

{
  "_id": {
    "$oid": "5bdb0c00821ee43b005a7354"
  },
  "source": "SWAGGERHUB-FRONTEND",
  "logger": "server.thrown",
  "level": "ERROR",
  "message": "Error: Missing GitHub OAuth credentials",
  "requestId": null,
  "throwable": {
    "stackTrace": [
      ...
    ]
  },
  "timestamp": {
    "$date": "2021-07-01T14:21:52.029Z"
  }
}
swaggerhub.log Startup and shutdown logs of SwaggerHub services.
system.info Contains the operating system name and version, kernel version, and memory usage (as reported by /proc/meminfo).
upgrade-server.log,
upgrade-server.log.0,
upgrade-server.log.1
and so on
Upgrade log.
usage.info Contains the number of existing organizations, users, APIs and domains in your SwaggerHub On-Premise instance.

See Also

Audit Logs
Troubleshooting Single Sign-On in SwaggerHub On-Premise

Highlight search results