Alerts and notifications

Nerdio Manager enables you to send notifications via email or custom APIs based on a flexible set of conditions.

Before you can configure alerts and notifications, you must configure Azure Communications Services and/or linked mailboxes. You must have at least one active email address before you can configure notifications.

Manage Azure Communications Services domains

You may add Azure Communications Services (ACS) domains that contain email addresses to be used for sending notifications.

To add ACS domains:

1. At the MSP level, select from the following:

   • Classic UI: Navigate to Settings > Environment, locate the Notifications tile, and under Domains (Azure Communications Services), select Add.

     

   • New UI: Navigate to Settings > Environment, and scroll down to the Notifications section. Select the down arrow to expand that section, and in Domains (Azure Communications Services), select Add Domain Name.

     

2. On the Add Domain window, enter the ACS domain and select Apply.

   

To remove ACS domains:

1. At the MSP level, select from the following:

   • Classic UI: Navigate to Settings > Environment, locate the Notifications tile, and under Domains (Azure Communications Services), select Remove.

     

   • New UI: Navigate to Settings > Environment, and scroll down to the Notifications section. Select the down arrow to expand that section, and in Domains (Azure Communications Services), select the trash can icon.

     

2. In the Remove address dialog box, select OK.

To verify an ACS domain:

1. At the MSP level, select from the following:

   • Classic UI: Navigate to Settings > Environment, locate the Notifications tile, and in Domains (Azure Communications Services), select Verify. In the Confirm action dialog box, select OK. To display the status of the verification process, hover over the icons.

     

   • New UI: Navigate to Settings > Environment, and scroll down to the Notifications section. Select the down arrow to expand then section, and in Domains (Azure Communications Services), select the verify icon. The status is displayed. Hover over each status box to display more details.

     

Manage Azure Communications Services email addresses

You may add Azure Communications Services (ACS) email addresses that are in the configured domains for sending notifications.

To add ACS email addresses:

1. At the MSP level, select from the following:

   • Classic UI: Navigate to Settings > Environment, locate the Notifications tile, and in Addresses (Azure Communications Services), select Add.

   • New UI: Navigate to Settings > Environment, and scroll down to the Notifications section. Select the down arrow to expand that section, and in Addresses (Azure Communications Services), select Add Email Address.

2. Enter the following information:

   • Email: Enter the email address.

   • Domain: From the drop-down list, select the ACS domain.

3. Once you have entered the desired information, select OK.

To set a default ACS email address:

1. At the MSP level, select from the following:

   • Classic UI: Navigate to Settings > Environment, locate the Notifications tile, and in Addresses (Azure Communications Services), select Set default for the email address you want to set as the default.

   • New UI: Navigate to Settings > Environment, and scroll down to the Notifications section. Select the down arrow to expand that section, and in Addresses (Azure Communications Services), select the star icon for the email address you want to set as default.

To assign an email address to an account:

1. At the MSP level, select from the following:

   • Classic UI: Navigate to Settings > Environment, locate the Notifications tile, and in Addresses (Azure Communications Services), select Assign accounts for the email address you want to assign accounts to.

   • New UI: Navigate to Settings > Environment, and scroll down to the Notifications section. Select the down arrow to expand that section, and in Addresses (Azure Communications Services), select the assign accounts icon for the email address you want to assign accounts to.

2. In the Update assignments dialog box, from the drop-down list, select the account.

3. Select OK.

To remove an ACS email address :

1. At the MSP level, select from the following:

   • Classic UI: Navigate to Settings > Environment, locate the Notifications tile, and in Addresses (Azure Communications Services), select Remove for the email address you want to delete.

   • New UI: Navigate to Settings > Environment, and scroll down to the Notifications section. Select the down arrow to expand that section, and in Addresses (Azure Communications Services), select the trash can icon for the email address you want to delete.

2. In the Remove address dialog box, select OK.

Set Azure Communications Services limits

You may set Azure Communications Services (ACS) limits. This includes the maximum number of messages per hour and per month.

To set ACS limits:

1. At the MSP level, select from the following:

   • Classic UI: Navigate to Settings > Environment, locate the Notifications tile, and in Limits (Azure Communications Services), select the pencil icon to edit Messages per hour or Messages per month, and then enter a new value.

     

   • New UI: Navigate to Settings > Environment, and scroll down to the Notifications section. Select the down arrow to expand that section, and in Limits (Azure Communications Services), enter an updated value in the Messages per hour or Messages per month boxes respectively.

     

2. Optionally, select the refresh icon to refresh the number of messages that have been sent this month.

Linked mailboxes

Link mailboxes that can be used for sending notifications.

To create a new linked email:

1. At the MSP level, select from the following:

   • Classic UI: Navigate to Settings > Environment, locate the Notifications tile, and in Linked Mailbox, select Link mailbox.

   • New UI: Navigate to Settings > Environment, and scroll down to the Notifications section. Select the down arrow to expand that section, and in Linked Mailbox, select Link Mailbox.

2. Review the information displayed in the Link Exchange online mailbox dialog box, and then select Login.

   Note: When you select Login, you are redirected to a sign-in page for the send from user account.

3. Sign in as a user with an active mailbox to be used as the Send From address for sending email notifications. This mailbox is added to the list of linked email addresses.

4. Repeat the steps above for every mailbox you wish to link.

5. Once the mailbox is linked, you have a number of management tasks you can perform:

   • Classic UI:

     • Set default:Set the selected mailbox as the default.

     • Test:Send a test email from the mailbox to an address you enter.

     • Assign accounts: Assign accounts to this mailbox.

     • Unlink: Unlink the mailbox.

     • Relink mailbox: Relink a mailbox

   • New UI:

     • Select the icon to set the mailbox as default.

     • Select the icon to assign a mailbox.

     • Select the icon to send a test email from the mailbox to an address you enter.

     • Select the to unlink a mailbox.

     • Select the to relink a mailbox.

Examples of conditions

Consider the following examples of conditions:

• Auto-scale errors: This condition is triggered when any task started by the Auto-scale user results in an error.

  

• Failed Desktop Image Creation: This condition is triggered when the Power off & set as image or the Update 'set as image' schedule configuration tasks result in an error.

  

Conditions overview

Conditions allow you to specify which actions or states trigger a notification.

• Nerdio Manager allows you to create conditions for tasks, reservations, usage, and backups, as detailed below.

• Nerdio Manager contains several out-of-the-box conditions such as Buy AHB licenses and Buy RIs.

• From the Notifications > Conditions page, you can add, edit, or delete conditions.

Create a new condition

Nerdio Manager allows you to create conditions for tasks, reservations, usage, backup, Intune, and Defender for Endpoint.

To create a new condition:

1. At the MSP level, navigate to Notifications > Conditions.

2. Select Add Condition.

   

3. Enter the following information:

   • Name: Type the name of the condition.

     Note: You need to specify this name when creating a corresponding notification action.

   • Notification Type: From the drop-down list, select the notification type for this condition. The following notification types are available:

     •       Task condition

     •       Reservations condition

     •       Usage condition

     •       Backup condition

     •       Intune condition

     •       Defender for Endpoint condition

     •       AD user management

     •       Software updates

     •       Risky users

     •       Secure score

     •       Azure file share capacity

     •       Policy management

     •       Azure Capacity Extender

   • Severity: From the drop-down list, select the severity for this condition.

   • Accounts: From the drop-down list, select the account(s) to associate with this condition.

4. Once you have entered the desired information, select OK.

      Task condition

Nerdio Manager allows you to create conditions for tasks.

• Targets: From the drop-down list, select the target(s).

  Note: The targets can include all tenants and workspaces, or they can be confined to a specific tenant or workspace, or a single host pool.

• Tasks: From the drop-down list, select the task(s).

  Note: These are the action or actions that are evaluated. Examples include Add host, Disconnect user session, Stop VM, etc.

• Run By: From the drop-down list, select the interactive user(s) or background process(es) that triggered the task.

• Failure Statuses: From the drop-down list, select the failure status (either cancelled, completed, or error) that this condition should match.

• Success Statuses: From the drop-down list, select the status(es) (for example, completed) that this condition should match.

  

      Reservations condition

Nerdio Manager allows you to create conditions for reservations.

• Type: From the drop-down list, select the reservation condition type. For example, the reservation is about to expire.

• Period (in days): For RI is about to expire, type the period, in days, for which the notification is sent.

  

      Usage condition

Nerdio Manager allows you to create conditions for usage.

• Type: From the drop-down list, select the usage condition type. For example, CPU usage.

• Targets: From the drop-down list, select the object(s) the condition applies to. For example, servers or host pools.

• Failure Threshold (%): Type the limit value of the target metric, above which the notification is sent.

• Success Threshold (%): Type the limit value of the target metric, below which the internal ticket will be resolved.

• Send Every: From the drop-down list, select how often to send subsequent alerts once the first alert has been sent.

  Note: The system checks if the threshold is exceeded every 10 minutes. Once the first alert has been emailed, you can mute future notifications for a period of time to avoid excessive notifications.

  

      Backup condition

Nerdio Manager allows you to create conditions for backups.

• Type: From the drop-down list, select the type of resources that the condition applies to.

• Target Name: Type the resource name(s), separated by commas, the condition applies to.

  Note: If you leave the Target Name blank, notifications for all items being backed up in the linked Backup Repository and Resource Group are sent.

• Failure Statuses: From the drop-down list, select the backup status(es) the condition applies to.

• Success Statuses: From the drop-down list, select the backup status(es) the condition applies to.

  

      Intune condition

Nerdio Manager allows you to create conditions for Intune conditions.

• From State: From the drop-down list, select the device's state it moved from.

• To State: From the drop-down list, select the device's state it moved to.

• Targets: From the drop-down list, select the Intune device type (model).

  

      Defender for Endpoint condition

Nerdio Manager allows you to create conditions for Defender for Endpoint.

• Health State From: From the drop-down list, select the device's state it moved from.

• Health State To: From the drop-down list, select the device's state it moved to.

• Risk Score: From the drop-down list, select the risk score.

• Alert Severity: From the drop-down list, select the alert severity.

• Incident Severity: From the drop-down list, select the incident severity.

  

      AD user management

Nerdio Manager allows you to create conditions for AD user management.

• Type: From the drop-down list, select the type.

• Failure Statuses: From the drop-down list, select the status(es) this condition should match.

• Success Statuses: From the drop-down list, select the status(es) this condition should match.

  

      Software updates

Nerdio Manager allows you to create conditions for Nerdio Manager software updates.

      Risky users

Nerdio Manager allows you to create conditions for risky users.

• From Risk State: From the drop-down list, select the risk state.

• To Risk State: From the drop-down list, select the risk state.

• Aggregation type: From the drop-down list, select the aggregation type.

  Note: Selecting Per User creates individual notifications for each user as the state changes. Selecting As Group creates a single notification for all devices that have state changes.

  

      Secure score

Nerdio Manager allows you to create conditions for secure scores.

      Azure file share capacity

Nerdio Manager allows you to create conditions for Azure file share capacity alerts.

      Policy management

Nerdio Manager allows you to create conditions for policy management alerts.

• Policy Types: From the drop-down list, select the type of policy.

• Policies: From the drop-down list, select the policy.

• Failure Statuses: From the drop-down list, select the failure status. These indicate that a drift has been detected.

• Success Statuses: From the drop-down list, select the success status. These indicate that a drift has not been detected.

  

      Azure Capacity Extender

Nerdio Manager allows you to an create conditions for sending a notification when capacity extender is used to notify of a change in VM families or VM size (SKU).

• Targets: From the drop-down list, select the objects that this condition will apply to.
• Tasks: From the drop-down list, select the tasks that this condition will apply to..
• Run By: From the drop-down list, select the interactive user or background process that triggers the task.

• Failure Statuses: From the drop-down list, select the failure status. These indicate that a drift has been detected.

• Success Statuses: From the drop-down list, select the success status. These indicate that a drift has not been detected.

  

Create a new action

Actions are the notifications to send out if a condition is matched. You may send out a notification via email or custom API.

To create a new action:

1. At the MSP level, navigate to Notifications > Actions.

2. Select Add.

   

3. Enter the following information:

   • Conditions: From the drop-down list, select the conditions(s) to match.

   • Send an Email Notification?: Select the option to send email notifications.

     • Send From: From the drop-down list, select a linked email address that is used to send the notification.

       Note: Only linked mailboxes are displayed. Navigate to Settings > Environment > Notifications to link mailboxes.

     • Send To: Type the email address(es) to send the notifications to.

       Note: Multiple emails can be specified separated by commas.

     • Subject: Type the subject line of the email.

     • Body: Type the body of the email.

       Note: You may use any environmental variables in the subject and body of the email. Consider the following example:

       

       See MSP-level variables for details about environmental variables.

   • Send a Custom API Notification?: Select the option to send notifications via custom APIs.

     • Custom API Endpoint: Type the custom API endpoint URL for the POST requests.

     • Custom API Key: Type the API key for request authentication.

     • Show request sample: Select this to see the sample POST command.

4. Once you have entered the desired information, select OK.

   The action is created. From the Notifications Actions page, you may edit, deactivate, or delete actions.

Bulk actions for conditions and actions

Nerdio Manager allows you to perform bulk actions on conditions and actions.

To perform a bulk action:

1. In the list of conditions or actions, select the one(s) you want to work with by selecting them in the left-most column . Optionally, select all the conditions or actions by selecting the tick icon at the top.

   

2. Once you have made your selections, at the bottom, select Select bulk action.

   

3. Select the bulk action you wish to perform.

4. If prompted, confirm the bulk action you selected.