Activity Screen

Activity Screen

Most problems can be solved by looking at the Activity screen and following steps described on the errors displayed there. The Activity screen can be seen by clicking on 'Activity' in the top right corner of the web application menu bar:

Activity Screen

Issues 

The Issues tab shows issues that arise from invalid Tasktop configuration or from more global issues, such as having an invalid or expired license. These are things that can generally be resolved within the Tasktop application itself. 

(lightbulb) Issues can block integrations from running, so it is recommended that users monitor the Issues tab regularly.

Issues Tab

An additional warning icon appears when these issues are so fundamental that they will prevent integrations from running. 

The hover message will indicate whether the issue will prevent all integrations from running (for example, licensing errors), or  just affected integrations from running (for example, a configuration error that impacts just one integration).

Hover Icon

You can use the search box to search for specific issues, or filter based on issue impact (blocks all integrations, blocks affected integrations, or other/unknown).

You can take the following actions on the Issues tab:

  •  Retry: Retry an issue.  This action is only available for configuration migration issues.  
  •  Resolve: Resolve an issue.  This action is only available for certain issue types, and can be taken to acknowledge that the user has reviewed the issue and taken any required user actions.
  •  Remove: Remove an issue.  If that issue was blocking an integration, the integration will become unblocked.  However, if the cause of the issue has not been resolved, the issue will return to the Issues tab the next time configuration validation occurs (once an hour).  You can also Remove All issues from the Bulk Actions menu.

You can also take the following Bulk Actions:

  • Refresh: Refresh the issues tab.
  • Remove All: Remove all issues.  If the issues were blocking an integration, the integration will become unblocked.  However, if the cause of the issue has not been resolved, the issue will return to the Issues tab the next time configuration validation occurs (once an hour).  

Background Jobs 

The Background Jobs tab shows progress on background Tasktop processes such as:

While jobs are processing, you will see a progress bar to track progress.  Jobs that are in progress cannot be canceled.

Background Jobs Tab
You can filter the Background Jobs tab by job status (pending, error, completed), by job type, or by typing in search terms
Background Jobs Filters
If a background job encounters an error, that error will show up on the Background Jobs tab color coded in red (and not on the Errors tab).  If there is an associated issue, a link will be shown to navigate to that issue.  These jobs will be re-tried automatically until they complete, and can be prioritized using the 'prioritize' button.
Prioritize Failed Background Job
Similarly, once jobs complete, you will see them on the Background Jobs tab color coded in green (they will not show up in the 'Past Activity' tab, since Background Jobs are a different type of event from current activity).  For Project Replacement jobs, you can expand the 'Projects Updated' section to see additional details:

Expanded 'Projects Updated' Section
Activity listed on the Background Jobs tab will be cleared after each Tasktop upgrade.

Current Activity

The Current Activity tab shows events that are active in an integration.

Current Activity encompasses the following:

  • Pending: Events that are queued up to be processed.
  • Processing: Events that are currently processing.
  • Error: Events that Tasktop tried to process, but were not successful.

You can take different actions on the events in these subcategories, which are outlined in the sections below.

Current Activity Tab

You can filter each type of current activity by entering search terms, by filtering on integration status (running or stopped), or by filtering on integration name.  Click 'Filters' to expand your filter options.

Expand Filters

Filter Options

Each category also allows you to take bulk actions:

Bulk Actions

(lightbulb) Note: The number of events in the summary banner will update regularly, but the list of events themselves will need to be refreshed to show new activity. This is to avoid items unexpectedly appearing and disappearing when you might be examining them. 

 Updated List of Errors

Pending 

On Pending Activity, you can take the following actions:

    •  Prioritize: Prioritize this pending event in the queue.
    •  Cancel: Remove this event from the pending queue. It will not be processed, though subsequent changes to artifacts will trigger another event.
    •  Ignore: If an error is pending, you have the option of moving it to the Ignored Errors tab.  See Errors section for details.

Processing

The Processing tab shows activity that is currently processing.  There are no actions that can be taken here.

Error 

The Error tab shows any errors related to specific activities that have occurred.  In contrast with the Issues Tab, errors typically block individual artifacts (rather than entire integrations), and therefore are less severe.

You can take the following actions:

    •  Prioritize: Prioritize the retry of this error in the queue. This option is especially useful if you have made changes in your repository or in Tasktop that will likely clear up the error.
      • You will see this action if the event is already set to be retried, and is hence both in "error" and "pending" states simultaneously.
    •  Retry: Retry this error. 
      • You will see this action if the event is not already set to be retried.
    •  Cancel: Remove this error from the list. It will not be retried, though subsequent changes to artifacts will trigger another event.
    •  Ignore: Move the error to the 'Ignored Errors' list.  Once ignored, it will no longer show up in the Errors list (or in Pending), and it will not be counted in the Error summary counts at the top of the screen.
    •  Recreate: If a previously-sync'ed artifact has been deleted in one of your repositories, you have the option of recreating it from the Activity screen. This will keep the newly recreated artifact in sync with the source artifact.

Actions on Error Screen
(star) Note: Most errors will automatically be retried on a gradually decreasing interval (granted that Tasktop can locate the artifact that is to be changed). Retryable errors will be retried approximately 30 seconds after they are first encountered, and then on a gradually decreasing interval over time.

You can see information about retries on the error itself. In the example below, you can see that the error has been retried 5 times, and that it has been scheduled for processing in 5 minutes. If an error will not be retried, this information will not be be relevant and hence will not be displayed.

Error Processing Information

A complete listing of errors is available in the appendix.

You can also find additional information on select errors in our FAQ.

Ignored Errors 

If you ignore an error, it will be moved to the Ignored Errors list, and no longer be counted in the Errors total at the top of the screen.  Note that though ignored errors will no longer show up in the Errors or Pending tabs, ignored errors will still continue to process, so if the source of the error is resolved, the event will move to the Processing tab, and then to the Past Activity tab.

Ignored Errors List

You can move an error back to the Errors list by clicking 'Stop Ignoring.'

Stop Ignoring Error

If you'd like to use the bulk action, 'Stop Ignoring All,' you must first apply a filter to the Ignored Errors list.  This will move all errors that meet your search filters back to the Errors list.

'Stop Ignoring All' Bulk Action

Past Activity

The Past Activity tab allows you to view all past integration activity, so that you can understand what has successfully completed.

There are three types of Past Activity:

  • Created Artifact: When a new target artifact is created in a repository
  • Updated Artifact: When an existing artifact is updated in a repository
  • Associated Artifacts: When existing artifacts are auto-matched, and therefore associated with one another.  Currently this is only supported for containers, when utilizing Container Matching for a Work Item + Container Mirroring synchronization integration.

Past Activity Tab

You can click the drop down arrow on each activity to see more details on the activity that has occurred

Click Drop-Down Arrow to Display Details

(lightbulb) If past activity is indicating that a new artifact was created, you'll see that the Original Values listed are blank, and that the Activity type is 'Created Artifact' as opposed to 'Updated Artifact'

'Created Artifact' Activity Type

If you'd like to filter your results, you can use the search box on this page to refine your results. Additionally, you can click 'Filters' to expand additional filtering options.  You can use the integration filter to search by integration, or the date filter to search either by a fixed date range or by a set number of days in the past (which will dynamically update your results as days pass).

Past Activity Filters

You can also use the Bulk Actions to refresh, or remove all past activity that meets your current search filters. If you have not entered any search filters, all past activity will be refreshed or removed.

(warning) Note that Tasktop will store up to 100,000 entries on the Past Activity screen. Once 100,000 entries are met, older entries will be deleted as new entries come in. You can also opt to clear your entries when approaching 100,000 to have better visibility into more recent past activity.