orchestrator
2021.10
false
UiPath logo, featuring letters U and I in white
OUT OF SUPPORT

Orchestrator User Guide

Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated Oct 31, 2024

Alerts

Alerts are real-time notifications related to robots, queue items, triggers, and more. You receive alerts for all the folders to which you have access. You can view alerts quickly in the notification panel, or review them in detail on the Alerts page.

Alerts can refer to:

  • different severities of events (info or warning, for example)
  • different components (Triggers, Actions, and more).

Subscribing or Unsubscribing From Alerts

You have the possibility to subscribe or unsubscribe from alerts on the Profile page. A toggle is available for each component: Transactions, Robots, Jobs, Actions, Triggers, Queues, and Cloud Robots.

If you are subscribed to alerts, they appear in the Alerts notification panel and you can view their details on the Alerts page. If you unsubscribe, you cannot see alerts related to the components for which you unsubscribed in either place.

If you don't have at least View permissions on a component, the no alert icon is displayed next to it and you don't receive any of the corresponding alerts, even if the toggle is switched on.



Alert Notifications

When new alerts are generated, a red badge appears on the Alerts icon in the top right:



Click the icon to open the Alerts panel, where you can view the five most severe alerts:





The notification panel displays a maximum of 5 alerts ordered according to severity and creation time. Higher severity alerts are displayed first; if there are several alerts with the same severity, the latest ones are displayed first.

To remove an alert from the Alerts panel, you must mark it as read from the Alerts page.

From the notification panel, you can navigate to:

  • the Alerts page by clicking See All Alerts at the bottom
  • to your Profile page where you can subscribe or unsubscribe from alerts by clicking Open Alerts Preferences in the top right corner of the panel.

Viewing Alerts

You can view all alerts to which you have access on the Alerts page, which you can access by going to Tenant > Alerts.



Viewing Alert Details

If you want to learn more about an alert, click the info icon at the right end of the row to open the Alert Details window:



Note: By exception, alerts for the Triggers component do not have any further details so there is no info icon available for them.

Alert Classification

Alert Severity Levels

The severity levels of alerts apply to different types of notifications, as follows:

  • Info - Robots now available; User assigned as reviewer for failed/abandoned queue item; User assigned/unassigned/reassigned from one or multiple tasks.
  • Warn - Queue items that fail with business exceptions.
  • Error - Jobs that fail, be they scheduled or manually started; Robots not responding; queue items that fail with application exceptions, queue triggers not able to create new jobs.
  • Fatal - Robots that go offline or are disconnected.
  • Success - Alerts generated using the Raise Alert activity.

When filtering the Alerts page according to the Severity level, please note that all greater severity levels are also displayed. For example, if you select Warn, messages are going to be displayed for the Warn,Error and Fatal severity levels.

The default value of the filter is Info. This means that removing all filters displays alerts having Info severity and above.

Note:

All alerts with lower severity levels (Info,Warn,Success) are marked as read in the Alerts grid.

Only Fatal and Error alerts are sent via Error summary email reports.

Alert Severity by Component

Component

Severity

Scenario

Jobs

Error

Job faulted

Jobs

Error

Job not created

Robots

Fatal

Robot is disconnected

Robots

Error

Robot is unresponsive

Robots

Info

Robot is available

Schedules

Error

BackgroundJob trigger misfired

Schedules

Error

BackgroundJob failed to execute

Transactions

Error

Queue item failed with ApplicationException

Transactions

Warn

Queue item failed with BusinessException

Transactions

Info

User assigned as reviewer for failed/abandoned queue item

Queues

Error

A breach of the SLA is predicted for a queue.

Tasks

Info

User assigned/unassigned/reassigned from one or multiple tasks

Triggers

Info

Trigger could not create a job as the maximum number of jobs has been reached. Occurs on queue triggers.

Triggers

Error

Trigger could not create jobs as the allocated Robots already have pending jobs for this process. Occurs on time triggers.

Process

Success

Process alert - alerts generated using the Raise Alert activity

Folders

Success

"Folder <folderName> was successfully deleted."

Folders

Error

"The folder <folderName> was restored."

Generated in case of a failure.

Folders

Error

"Deletion of folder <folderName> failed. The folder was restored as <folderName>."

Generated in case of a failure and when a new folder with the same name is created at the same time, which means the original folder is renamed at restore.

Personal Workspaces

Info

"User <userName> started exploring your personal workspace."

Sent to the owner of a personal workspace when an admin begins exploring their workspace.

Personal Workspaces

Info

"User <userName> finished exploring your personal workspace"

Sent to the owner of a personal workspace when an admin stops exploring their workspace.

Personal Workspaces

Info

"Your personal workspace was converted to a folder: <folderName>"

Generated when a personal workspace is converted to a folder.

Personal Workspaces

Info

"User <folderName> deleted your personal workspace. A new empty personal workspace was created for you"

Sent to the owner of a personal workspace when their workspace is deleted.

Personal Workspaces

Success

"Enabling personal workspaces successfully completed"

Generated when bulk enabling personal workspaces succeeds.

Personal Workspaces

Error

"Enabling personal workspaces failed"

Generated when bulk enabling personal workspaces fails.

Custom Alerts

Custom alerts can be sent to Orchestrator using the Raise Alert activity, which lets you add custom messages in the Alerts page, with a selected severity.

Setup

The activity runs under the robot which executes it.

To execute this activity in Studio, the robot has to be connected to Orchestrator and the Robot role must have View,Create, and Edit permissions on Alerts.

Result

All custom alerts are raised in Orchestrator under the Process component. The string added in the activity's Notification field is the message which appears in the Orchestrator Alerts page.

Alerts having either Fatal or Error severity are also included in emails.

Permission to View Alerts

To view alerts, users require the tenant permission Alerts - View. This allows them to see all tenant-level alerts.

At the folder level, users can only see alerts for the folders to which they are assigned.

Important: Users do not inherit alert subscription settings from the parent group, nor do they receive any alerts by default. To allow users to view alerts, explicitly grant the corresponding permissions to users.

Email alerting localization

When you enable the email alerting feature, take into account the following scenarios:

  • Email alerts sent to an email-enabled AD or AAD group use the language you set at the Orchestrator organization level. This type of email alert disregards the recipient group's email language settings.
  • Email alerts sent to an individual user use the language based on the following order:
    • The individual user’s language.
    • The tenant's language.
    • The application-level's default language.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.