- Getting started
- Best practices
- Tenant
- Folders Context
- Automations
- Processes
- Jobs
- Triggers
- Logs
- Monitoring
- Queues
- Assets
- Storage Buckets
- Test Suite - Orchestrator
- Other Configurations
- Integrations
- Classic Robots
- Host administration
- About the host level
- Managing system administrators
- Managing tenants
- Configuring system email notifications
- Audit logs for the host portal
- Maintenance Mode
- Organization administration
- Troubleshooting
Orchestrator User Guide
Machines
Displays information about all the existing runtimes on an aggregate basis, and allows you to check the overall health of each runtime. You can group the runtimes per host machine, in case you wish to have an overview of how your workstations are performing.
The Include Subfolders checkbox enables you to select if the contents of all subfolders are included.
The Group by Machine toggle enables you to group the runtimes per each connected host machine.
Group by Machine enabled
All the runtimes on one machine template are grouped together in one entry for each workstation that is connected to Orchestrator. The different blocks represent each such host machine. Hovering over each block displays an overview of that workstation:
Field |
Description |
---|---|
1 |
The name and status of the host machine. See below a breakdown of the host machine statuses. |
2 |
The name of the machine template used to connect the workstation to Orchestrator |
3 |
The status of the machine. They are detailed in the table below. |
4, 5, 6 |
The type of each runtime, their licensing status, the total number of runtimes for each type, and the available runtimes of the total. |
Host Machine Status
Color |
Meaning |
---|---|
Red |
Unresponsive The workstation is unresponsive. |
Orange |
Unlicensed For that workstation, there are no available licenses on the tenant for any of the runtimes that have been assigned to the associated template. Example Tenant Level: 4 Unattended Runtimes Purchased Machine Template: 2 Unattended Runtimes Assigned I connect three workstations to Orchestrator using that machine template. Required Licenses: 3 x 2 = 6 Due to only having 4 licenses at tenant level, two workstations are fully licensed, one is unlicensed. |
Yellow |
Partially Licensed For that workstation, only a portion of the runtimes associated to the template are available on the tenant. Example Tenant Level: 3 Unattended Runtimes Purchased Machine Template: 2 Unattended Runtimes Assigned I connect two workstations to Orchestrator using that machine template. Required Licenses: 2 x 2 = 4 Due to only having 3 licenses at tenant level, one workstation is fully licensed, one is partially licensed. |
Green |
Available None of the available runtimes are consumed to execute a job. |
Cyan |
Partial Usage Only a portion of the total available runtimes is consumed. Example Say I have two unattended runtimes on a machine template, used to connect one host machine to Orchestrator. If I am executing one unattended job, it consumes one unattended runtime. As such, the workstation is displayed as having partial usage. |
Blue |
Full Usage All runtimes are consumed. Example Say I have two unattended runtimes on a machine template, used to connect one host machine to Orchestrator. If I am executing two unattended jobs, it consumes two unattended runtimes. As such, it is displayed as having full usage. |
Group by Machine disabled
The runtimes are displayed separately. The various statuses represent the health of each runtime. Each runtime is represented with a colored block. Hovering over each block displays an overview of that runtime:
1 |
The name of the workstation. |
2 |
The name of the machine template used to connect the workstation to Orchestrator - displayed in parenthesis. |
3 |
The type of runtime. |
4 |
The status of the runtime. They are detailed in the table below. |
Runtime Status
Color |
Meaning |
---|---|
Red |
Unresponsive The host machine associated to that runtime is unresponsive. If there are multiple runtimes associated to a workstation that is unresponsive, all are displayed as unresponsive. Example If I have 3 NonProduction runtimes on a machine template that is used to connect one workstation to Orchestrator, and that workstation becomes unresponsive, then all three runtimes are displayed as unresponsive. |
Orange |
Unlicensed There are no available licenses at tenant level for that runtime. |
Green |
Available The runtime is available for execution. |
Blue |
In use The runtime is consumed during job execution. |
Allows you to see the runtime allocation per host machine and machine template such that you can assess whether a machine needs more runtimes or not. Similarly, you can see if you have allocated too many runtimes to a machine.
Data in the table gets updated accordingly as you allocate more runtimes or start a job on a machine.
Field |
Description |
---|---|
Connected Machine |
The name of the host machine. |
Machine |
The name of the template whose key is used to connect the Robot on the corresponding host machine to Orchestrator. |
Type |
The type of runtimes associated to that machine template. If there are multiple types on the same machine template, an entry is generated for each. |
Status |
The status of each runtime, illustrated with a colored icon and its description. They are described in the section above. |
Runtimes |
The number of runtimes of each type. |
In Use |
The number of runtimes currently being consumed. A runtime is only consumed during job execution. |
Last Heartbeat |
The amount of time since the last heartbeat. Hover over this field to see the exact time of the last heartbeat. |
Search |
Enables you to search according to the host machine name, and template name. |
Columns |
Enables you to toggle column visibility. By default, all columns are displayed. Clear or select the check boxes corresponding to the columns you want to stay hidden or visible, respectively. Click Reset in the Visible Columns drop-down to return to the default configuration with all columns enabled and visible. |
It illustrates the ratio between unresponsive, unlicensed, available and in use runtimes in a pie chart.
Color |
Meaning |
---|---|
Red |
Unresponsive The host machine associated to that runtime is unresponsive. If there are multiple runtimes associated to a workstation that is unresponsive, all are displayed as unresponsive. Example If I have 3 NonProduction runtimes on a machine template that is used to connect one workstation to Orchestrator, and that workstation becomes unresponsive, then all three runtimes are displayed as unresponsive. |
Orange |
Unlicensed There are no available licenses at tenant level for that runtime. |
Green |
Available The runtime is available for execution. |
Blue |
In use The runtime is consumed during job execution. |
Displays information concerning one Robot, as selected by the user from the general view, specifically on the Robots Overview widget. Each widget in this view contains the exact same information as on the Robots page. Changing the properties there automatically causes the information here to update accordingly.
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 Robot's activity.
The name of the Robot is displayed at the top left of the page.
Right below the Robot's name and Interval filter, you can find the following information concerning the selected Robot:
- Type - the Robot type;
- Username - the username used to connect the Robot to Orchestrator;
- Machine - the name of the machine on which UiPath Robot is installed;
- Running Process - the name of the process that is being executed.
Displays the name of the executed process, if any, and details pertaining to the associated job. Specifically, the time at which the job execution began and its approximate time of completion. If there is no ongoing job, the widget is not populated. The estimated time of completion is calculated based on previous executions of that job, if any. If the job is at its first execution, a dash is displayed instead. When the execution has ended, the widget returns to the original, unpopulated state.
Filtering by Interval does not impact this widget.
Allows you to see a list of the errors encountered on the selected Robot. The errors are displayed in reverse chronological order as they occur, meaning a new error is always displayed at the top of the feed. The number of errors displayed in parentheses after the widget name is expressed according to your position within the feed and to the total number of errors. Let's say there are 453 errors in your feed. The following behavior is encountered:
Position Within the Feed |
Displayed Value |
---|---|
Between 0 and 99 |
99+ |
Between 100 and 199 |
199+ |
Between 200 and 299 |
299+ |
Between 300 and 399 |
399+ |
Further than 400 |
The total number of errors in the feed, in this particular example 453. |
After reaching the end of the feed, the total number of errors is displayed regardless of your position.
You can dismiss an error after having acknowledged it, however, please take into account that multiple users might check the feed simultaneously, so we recommend carefully using the Dismiss button. A dismissed error is still taken into account in the error counter. After an error was dismissed, the name of the user who performed the action is displayed adjacently in a tooltip. Note that you need Edit permissions on Monitoring to dismiss errors.
Field |
Description |
---|---|
Time |
The time when the error occurred. |
Error Message |
The actual error message. Messages that have not been dismissed are displayed with bold formatting. Messages that have been dismissed are displayed with bold formatting. |
Dismiss |
Enables you to dismiss the specific error message. Clicking the Dismiss button removes the bold formatting from the text. A dismissed error is still taken into account in the error counter. After an error was dismissed, the name of the user who performed the action is displayed adjacently. Note that you need Edit permissions on Monitoring in order to dismiss errors. |
Copy |
Enables you to copy the text of the error message to the clipboard. |
Allows you to see precise figures of the jobs finished on the selected Robot and their end state. It enables you to assess what is the success rate of the jobs executed on a Robot. Unfinished jobs are not taken into account.
Job states are represented with colors as follows:
Color |
Tooltip |
---|---|
Green |
Successful |
Red |
Faulted |
Yellow |
Stopped |
The number in the middle of the chart represents the total number of jobs illustrated in the chart. The number on each slice represents the number of jobs in that specific state. You can filter out states by clicking the labels below the chart.
Precise figures of the queue items processed by the selected Robot and their final status. It provides metrics about the encountered exceptions enabling you to assess whether your queue items are failing or not.
Transaction states are represented with colors as follows:
Color |
Tooltip |
---|---|
Green |
Successful |
Orange |
Business Exceptions |
Red |
Application Exceptions |
The number in the middle of the chart represents the total number of transactions as illustrated by this widget. As an item gets successfully processed, the chart gets updated accordingly. The items are taken into account even if the impacted queue is deleted. You can filter out states by clicking the labels below the chart.