Instances
Important: Agents is currently in private beta and is not yet available to all customers.
An instance is an occurrence of an agentflow. An agentflow instance is created when an agentflow runs. A single agentflow can have multiple instances.
The Instances page shows a list of all agentflow instances. By default, this page displays running agentflow instances initiated during the last five days. For each agentflow instance, the list shows the name of the associated agentflow, and the initiated and completed dates.
Your agentflows and those shared with you are listed. Users with the Administrator role can view instances for all agentflows across the tenancy.
Jump to:
Access the instances page
-
Go to Agents > Instances.
Find and terminate instances
-
Go to Agents > Instances.
- In the Filters section, click Custom filter, complete the search parameters that you want, and then click Apply filter.
You can also click any of the default search links:
- Started last 5 days
- Failed last 5 days
- Running last 5 days
For more information on Custom filter, see Custom filter fields and selections.
Terminate currently running instances
-
Go to Agents > Instances.
- Click Select to terminate.
- Select the check boxes to the left of instances that you want to terminate. You can select multiple instances.
- Click Terminate.
You can also terminate instances from the Instance details page.
Delete instances
-
Go to Agents > Instances.
- Click Select to delete.
- Select the check boxes to the left of instances that you want to delete. You can select up to 50 instances to delete at one time.
Note: You can only select the most recent instance of a resubmitted instance. Deleting a resubmitted instance will delete all instances linked to that resubmitted instance.
- Click Delete. Instances may take some time to delete.
Drill down to instance details
-
Go to Agents > Instances.
- Click one of the search links:
- Started last 5 days
- Failed last 5 days
- Running 5 last days
- Custom filter
- (Optional) To include instances of deleted agentflows, click the Custom filter tab and select the Include instances of deleted agentflows to see deleted instances on the Deleted instances page.
Note: Only users with an administrator role can retrieve instances of deleted agentflows.
- If you searched for instances using a date range or custom filter, click the name of the instance that you want to view (instance names are listed in the first column).
The Instance details page appears. To go back to your search results, click Back to instances at the top of the page.
Instances columns and selections
The following columns or selections are displayed when you view the Instances page.
|
Section |
Column or selection | Description |
|---|---|---|
|
Filters |
Started last 5 days |
This is the default filter applied when the page loads. Shows all agentflow instances that were started within the last five days, regardless of the current status. |
|
|
Failed last 5 days |
Shows all agentflow instances that completed within the last five days and have a current status of Failed. |
|
|
Running last 5 days |
Shows all agentflow instances that were started within the last five days and are currently running. |
|
|
Custom filter |
Click to run a search of instances based on selected search criteria. For information, see Custom filter fields and selections. |
|
|
Refresh |
Click to refresh the page. |
|
|
Select to terminate |
Select the checkbox to select current running instances to terminate. |
| Select to resubmit | Select this checkbox to enable check boxes in the instances list to select instances to resubmit. You can select instances with Failed, Completed, or Terminated status. For more information, see Resubmit workflows. | |
| Select to delete | Select this checkbox to enable check boxes in the instances list to select instances to delete. You can select failed, completed or terminated instances to delete instance data. Once data is deleted, it can't be restored. For more information, see Delete instances. | |
|
(table) |
Instance name |
The name of the instance, which is derived from the following information:
Click the name of the instance to display the Instance details page. |
| Agentflow name | The name of the agentflow associated to the instance. | |
|
|
Status |
Current state of the instance. Possible values follow.
|
|
|
Date initiated | Date and time when the instance began running. |
|
|
Date completed |
Date and time when the instance reached completion. |
Custom filter fields and selections
The following fields or selections are displayed when you click Custom filter.
| Field or selection | Description |
|---|---|
| Agentflow name | Type the name of the agentflow from which you want to search instances. |
| Instance name | Type the name of the instance that you want to search. |
| Status |
Choose one of the following options:
|
|
Start date range |
Click the Date picker Select Preset or Custom.
Default value: Six days that includes the previous five days and today. For example, if the date today is September 30, then the default Start date range is from September 25 to 30. |
|
Include instances of deleted agentflows |
Select this check box to include instances from agentflows that have been deleted. Note: Only users with an administrator role can retrieve instances of deleted agentflows. |
| Apply filter |
Click to start the search. |
to select a date range.