Support and Usage Reports

Overview 

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 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 tasktop-state-DATE-TIME.zip. Once unzipped, there will be five folders. The folders and contents are listed below.

  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
    • change-detection-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 Tasktop Integration 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 Tasktop 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.
logs

thread-dump.log

Contains all Tasktop thread information at the point of time the Support and Usage report is downloaded. This file will only be included if your Tasktop instance has crashed or if you have forced Tasktop 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.
metrics

change-detection-metrics.json

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 Tasktop usage without any with personal information included (i.e. names, e-mail addresses, etc).
usageoverview.jsonContains details such as repository versions, number of integrations, number of activities (creates and updates) by integration and repository, and number of person IDs seen by integration and repository

Usage Reports 

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

Two reports are provided:

  • A sanitized report that does not contain personal information (such as names, e-mail addresses, or usernames), that is part of the Support and Usage Report file
  • A Customer Usage Report which contains personal information (such as names, e-mail 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 Tasktop, 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 Tasktop 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
    • Tasktop'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 Tasktop
  • 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 Tasktop has retrieved them yet (these fields are retrieved periodically).

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

Logging Settings

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