Support and Usage Reports


In cases where the Activity screen is not enough to resolve a problem, a Support and Usage Report is available to provide additional information.

The Support and Usage Report can be downloaded from the Help screen.

To download, click the Download Support and Usage Report link in the System Information section on the Help screen.

Download Support and Usage Report

Upon downloading, you can specify how many days of log files you'd like to include in the Support and Usage Report.

(lightbulb) Note: The default value for this field is set to 30 days.

Specify Date Range for Log Files

Report Contents

The downloaded report file is named Once unzipped, there will be five folders. The folders and contents are listed below.

(lightbulb) Note: The environment name will only appear in the file name if set in your Hub instance. Only the first 80 alphanumeric, underscore, or dash characters will be included in the environment name and all spaces will be converted to dashes.

  1. activity
    • issues.json
  2. configuration
    • configuration.json
    • hub-details.json
  3. crash-reports
    • hs_err_pid*.log
  4. logs
    • logs by day for past 14 days
    • configuration-changes.log
    • extensions.log
    • thread-dump.log
    • localhost.log

    • localhost_access_log.txt

    • catalina.log

    • tasktop-service.log

    • keycloak-service.log

    • keycloak-stderr.log

    • keycloak-stdout.log

  5. mappings
    • text file for each collection configured
  6. metrics
    • metrics.json
  7. repository metadata
    • file for each repository connection configured
  8. schemas
    • JSON file for each collection configured
  9. usage
    • usage report
    • overview.json
FolderFile NameContents
activityissues.jsonContains issues shown on the Activity screen.
configurationconfiguration.jsonContains all the configuration of your application instance.
configurationhub-details.jsonContains details about the specific build and license of the application.
crash-reportshs_err_pid*.logContains log files generated when the Java Virtual Machine crashes.
logslogsA separate file is created for every day of logs — 14 days of logs are saved.
logsconfiguration-changes.logContains details on configuration changes made in Hub, broken out by user (if applicable) and date/time. Note that the user is identified by their user ID, which can be found in the user administration screen (accessible by Hub admins only).
logsextensions.logContains any logs generated when an extension is called. The extension will write out a log whenever the console.log function is called. 
logsmigration-event-trace.logContains logs populated only when migrations are running.


Contains all Hub thread information at the point of time the Support and Usage report is downloaded. This file will only be included if your Hub instance has crashed or if you have forced Hub to close.

logslocalhost.logTomcat's host log
logslocalhost_access_log.txtTomcat's log of requests
logscatalina.logTomcat's container log
logstasktop-service.logTasktop Windows service log, showing service start and stop
logskeycloak-service.logKeycloak Windows service log, showing service start and stop
logskeycloak-stderr.logKeycloak standard error output
logskeycloak-stdout.logKeycloak standard output
mappingscollection-label.txt (i.e. jira-defects.txt)Contains information about collection mappings with transformation identifiers from Collection to Model and from Model to Collection.
metricsmetrics.jsonContains various metrics of the application.


Contains metrics relating specifically to integrations and change detection.
repository metadatarepository-label.json (i.e. jira.json)Contains repository metadata (i.e., repository version, repository timezone, repository api rate limit, repository default pagination size, repository additional metadata, connector timezone, repository state) for each repository connection configured.
schemascollection-label.json (i.e. jira-defects.json)

Contains collection schema information (i.e. the same fields that would display on the mapping screen).

usageusage-report.csvContains details on Hub usage without any with personal information included (i.e., names, e-mail addresses, etc).

Contains details such as repository versions, number of integrations, integration routes and last processed times, number of activities (creates and updates) by integration and repository, and number of person IDs seen by integration and repository.

(lightbulb) Note: Some integrations that do not have artifact associations will not have last processed times.

Usage Reports 

Hub supplies a Usage Report to enable customers to review and understand their Hub usage.  

Two reports are provided:

  • A sanitized report that does not contain personal information (such as names, email addresses, or usernames), that is part of the Support and Usage Report file
  • A Customer Usage Report which contains personal information (such as names, email addresses, and usernames), that can be used to analyze and reconcile user counts

Usage Reports

Both reports contain the following fields:

  • Tasktop Generated Person Identifier

    • This is generated to identify a person that flows between two or more repositories. If Person Reconciliation is in effect, the users that are the same across repositories will have the same Tasktop Generated Person Identifier. This field may be blank in scenarios where a person existed on an artifact seen by Hub, but where the field that contained that person did not flow to another repository.

  • Tasktop Generated Repository Person Identifier
    • This is generated for each unique person Hub sees within one repository. Note that the person field does not need to flow in order to be counted here.  Since this is repository-specific, you could see two (or more) different Tasktop Generated Repository Person Identifiers that share the same Tasktop Generated Person Identifier.
  • Connector
    • Hub's name for the connector
  • Repository Label
    • The name (label) supplied by the customer for the repository
  • Integration Name
    • The name supplied by the customer for the integration within Hub
  • Collection Project
    • The collection and project names that contain the person
  • Repository Fields
    • The repository fields that the person was seen on during the course of a month
  • Model Fields
    • The model fields mapped to the repository fields listed above
  • Count
    • The number of times the Tasktop Generated Repository Person Identifier was seen for the given integration/collection/project combo in one month
  • Month
    • The month that the count (above) applies to

The customer-facing report also contains the following fields:

  • First Name
  • Last Name
  • Display Name
  • Email
  • Username
  • Repository Person ID: 
    • A repository specific identifier.  Some repositories provide an ID that is unique from the username.

(lightbulb) Note: The customer-specific fields above may be blank depending on the associated repository and whether Hub has retrieved them yet (these fields are retrieved periodically).

Both reports contain data collected over a rolling 2 year span.

Logging Settings

Hub provides two logging levels for the logs in the support and usage reports: Normal and Troubleshooting. Please see the Logging section of the Troubleshooting (Settings) screen for more details on how to configure each setting.