UiPath Documentation
orchestrator
latest
false
Orchestrator user guide

Queues

Aggregate queue health metrics with adjustable data granularity for detailed performance overviews.

General View

Displays information about all the existing queues in the current folder on an aggregate basis, and allows you to check the overall health of the queues in your system. On this page, you can control the granularity of the displayed data, to have a more accurate overview of the metrics of your queues.

Filters

  • Interval - enables you to control the granularity of the data, and display either the last hour or hour, last day (last 24 hours) hours), last week (last 7 days) or last month (last 30 days) of your queues activity.
  • Include Subfolders - enables you to select if the contents of all subfolders are included.
    Note:

    Filtering impacts all widgets, unless specified otherwise in the dedicated section.

Queues Overview

Allows you to see an overview of the queue's health state so you can assess if there are any problems that would impact the entire system. Each color block represents a specific queue from your instance. Hovering over a block displays the name of the corresponding queue and its containing folder.

Note that it is possible to have multiple queues with the same name if each is in a different folder. The total number of queues is displayed in parentheses after the widget name. As a queue's state changes, the chart gets updated and the block color changes accordingly.

The various scenarios are represented with colored blocks and tooltips as follows:

ColorTooltip
GreyNo changes detected
GreenProcessing with no issues
OrangeQueue items soon overdue
RedQueue items processing failed with application exceptions Queue items overdue

Clicking a block displays the corresponding detailed view page. Click the arrow at the top-left of the page to return to the general view.

Filtering by Interval does not impact the red blocks in this widget.

Unprocessed Items

Allows you to see the overall status of all queue items so as to assess if your system is overloaded, and more Robots are needed to process everything in time. Starting an item-processing job causes the Items in Progress section to update accordingly.

The unprocessed queue items are broken down into three categories:

  • Newly Added Items - Items that were added in the selected interval regardless of their status.
  • Remaining Items - Items remaining to be processed.
  • Items in Progress - Items which are in progress.

Filtering by Interval only impacts the Newly Added Items section in this widget.

Transactions Overview

Allows you to see precise figures on items that were processed. It enables you to assess whether your queue items are failing or not. Please note that for failed items that were retried, each retry status is taken into account.

Note:

The transactions graphic on the Orchestrator Folder home page aggregates data based on the UTC timezone. This may lead to discrepancies when your folder is set to a different timezone. As a result, daily statistics in the graphic should be interpreted as “per day in UTC” rather than your local timezone.

Transactions states are represented with colors as follows:

ColorTooltip
GreenSuccessful
OrangeBusiness Exceptions
RedApplication Exceptions

The number in the middle of the chart represents the total number of transactions as illustrated by this widget. The number on each slice represents the transactions in that specific state. Once an item is processed, successfully or not, the chart gets updated accordingly.

Transactions Timeline

Allows you to see the timeline of processed items broken down according to their final status, in the selected interval. Please note that for failed items that were retried, each retry status is taken into account.

Transaction states are represented with colors as follows:

ColorTooltip
GreenSuccessful
YellowBiz. Exception
OrangeApp Exception
RedAbandoned

Once an item-processing job has finished or it has been stopped, the chart gets updated accordingly. Click a marker in the chart to see the exact corresponding value.

Queues Details

Allows you to see information pertaining to each queue and the corresponding items metrics. The total number of queues is displayed in parentheses after the widget name.

Field

Description

Queue

The name of the queue.

Click the arrows at the right of the column name:

  • once to sort data by name, in ascending alphabetical order;
  • twice to sort data by name, in descending alphabetical order.

No. of Items

The number of new queue items in the queue.

Deferred

The number of queue items that have a Postpone date.

Overdue

The number of items that have past their established Deadline .

On Time

The number of items whose processing falls in the expected estimated time, between the Postpone (if any) and Deadline dates.

AHT (Per Item)

The average handling time of a processed item, calculated on all items in the selected queue since it was created.

The time is displayed as a rounded-up value. The exact duration in ISO8601 format is shown when you hover over the displayed value.

Completion

The estimated completion time for the rest of the items based on the average handling time.

Folder

The folder where the Queue is located.

Search

Enables you to search by queue name.

Filtering by Interval does not impact this widget.

Individual View

Displays information concerning one queue, as selected by the user from the general view, specifically on the Queues Overview widget. Each widget in this view contains the exact same information as on the Queues page. Changing the properties there automatically causes the information here to update accordingly.

Filters

Interval - allows you to control the granularity of the data, and display either the last hour or last day (last 24 hours) of the selected queue's health state.

Transactions Overview

Allows you to see precise figures on items that were processed in the selected queue. It provides metrics about the encountered exceptions so that you can asses whether your queue items are failing or not. Please note that for failed items that were retried, each retry status is taken into account.

Transaction states are represented with colors as follows:

ColorTooltip
GreenSuccessful
OrangeBusiness Exceptions
RedApplication Exceptions

The number in the middle of the chart represents the total number of transactions as illustrated by this widget. Once an item is processed, successfully or not, the chart gets updated accordingly. You can filter out states by clicking the labels below the chart.

Unprocessed Items

Allows you to see unprocessed items in a queue broken down into two categories:

  • Items remaining to be processed
  • Items which are in progress.

This enables you to see the overall status of all the items in a queue so as to assess if your system is overloaded, and more Robots are needed to process everything in time. Starting an item-processing job causes the Items in Progress section to update accordingly. You can filter out states by clicking the labels below the chart.

Queue Dynamics

Allows you to see the number of items in the selected queue that were either added or processed, in the selected interval, thus enabling you to assess the efficiency of your system concerning item processing. You can filter out states by selecting the labels below the chart.

Retry Rate

Enables you to see your successfully processed queue items broken down according to the number of retries. The number of retries for successfully executed items are also taken into account in this widget. You can filter out states by clicking the labels below the chart.

Figure 1. Retry rate

Transactions Timeline

Allows you to see the timeline of processed items in the selected queue, broken down according to their final status, in the selected interval. Please note that for failed items that were retried, each retry status is taken into account.

Transaction states are represented with colors as follows:

ColorTooltip
GreenSuccessful
YellowBiz. Exception
OrangeApp Exception
RedAbandoned

Once an item-processing job has finished or has been stopped, the chart gets updated accordingly. Click a marker in the chart to see the exact corresponding value.

Processing Time

Enables you to see the average handling time of an item, calculated on all items in the selected queue since it was created, and the estimated completion time for the rest of the items based on that average. The Estimated Completion value is influenced by the number of Robots which are currently processing items, as well as by items that have a Defer Date. When no more unprocessed items are left in the queue, the value is set to N/A.

Filtering by Interval does not impact this widget.

Note that the durations are displayed as rounded-up values. The exact duration in ISO8601 format is shown when you hover over the displayed value.

Queue Item Failures by Reason

Failures are aggregated by failure reason and exception type (Application or Business).

  • Filter results by exception type, or group them by queue name or robot.
  • Select a failure reason to drill down to the individual failed queue items for that reason.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated