Working with Alerts and Conditional Alarms

1. Log in to the UniView Portal.
2. Click Protect and select the Microsoft 365 view.
3. To create a mapping, click and select an organization. Repeat as needed for each tenant.
   

NOTE   Backup alerts are not generated if the tenant has not been mapped to an organization in the UniView Portal.

4. Once mappings are created, BackupIQ generates an alert if one or more backups over the last 7 days is in Partial or Failed status, as shown below:

NOTE   Backup status information is received once per day from Spanning for Microsoft 365. An alert is generated if the Partial or Failed condition persists for 2 days.

• Organization link – Click to view organization details.
• Domain link – Click to view the Protect > Microrsoft 365 page, which shows tenant mappings, license and storage information, and the status of each tenant's recent backups (e.g., Mail Backup, Calendar Backup, Contact Backup, Drive Backup, SharePoint Backup, and Teams Channel Backup). For details, see Working with Microsoft 365.
• Module link – Click to access Spanning Backup for Microsoft 365.
• Platform link – Click to access Spanning.com.
  

1. Log in to the UniView Portal.
2. Click Protect and select the Google Workspace view.
3. To create a mapping, click and select an organization. Repeat as needed for each domain.
   

NOTE   Backup alerts are not generated if the domain has not been mapped to an organization in the UniView Portal.

4. Once mappings are created, BackupIQ generates an alert if one or more backups over the last 7 days is in Partial or Failed status, as shown below:

NOTE   Backup status information is received once per day from Spanning for Google Workspace. An alert is generated if the Partial or Failed condition persists for 2 days.

• Organization link – Click to view organization details.
• Domain link – Click to view the Protect > Google Workspace page, which shows domain mappings, license and storage information, and the status of each domain's recent backups (e.g., Site Backup, Document Backup, Mail Backup, Calendar Backup, and Contact Backup). For details, see Working with Google Workspace.
• Module link – Click to access Spanning Backup for Google Workspace.
• Platform link – Click to access Spanning.com.
  

1. Log in to the UniView Portal.
2. Click Protect and select the Salesforce view.
3. The Domain Name column lists your Salesforce organizations. To create a mapping, click and select an organization. Repeat as needed for each organization.
   

NOTE   Backup alerts are not generated if the Salesforce organization has not been mapped to an organization in the UniView Portal.

4. Once mappings are created, BackupIQ generates an alert if one or more backups over the last 7 days is in Failed status, as shown below:

NOTE   Backup status information is received once per day from Spanning for Salesforce. An alert is generated if the Failed condition persists for 2 days.

• Organization link – Click to view organization details.
• Domain link – Click to view the Protect > Salesforce page, which shows organization mappings, license and storage information, and the status of each organization's recent backups. For details, see Working with Salesforce.
• Module link – Click to access Spanning Backup for Salesforce.
• Platform link – Click to access Spanning.com.
  

1. Click the BackupIQ icon in the upper-right corner.
   
2. Alerts display:
   
3. (Optional) Click an asset to display asset detail. The following information is given for each asset:

• Type icon – Indicates the asset type. Hover over the icon for type description. Asset type examples: VMware, Windows, SQL, OS (for non-Windows assets protected by installing the Unitrends agent).
• Asset name– Name of the asset.
• Last Full Backup Size – Size of the last successful full backup.
• Last Local Backup – Number of minutes, hours, days, weeks, or months since the last backup.
• Last Backup Copy – Number of minutes, hours, days, weeks, or months since the last hot or cold backup copy. – displays if no backups have been copied.
  • Hot backup copies reside in the Unitrends Cloud or on a secondary appliance.
  • Cold backup copies reside on storage managed by other cloud storage providers (e.g., Amazon S3 or Rackspace) or on other backup copy media (e.g., a tape or NAS storage device).
• Last Certified – Number of minutes, hours, days, weeks, or months since the last backup was certified by a data copy access (DCA) job.
• Recovery Points – Lists the asset's local backups and backup copies. Scroll to view older recovery points.
  Icons display, indicating the status of each local backup and backup copy. Click a status icon to view job details. Hover over Legend for a description of each status.
  Hover over a backup copy icon to see whether it is a hot or cold copy.
  
• If a job is running, job details display. Click X to cancel a running job. Click See All to view all active jobs.
  

4. (Optional) Click to watch the Unitrends - Conditional Alarms video:
   
5. (Optional) Click to filter the list by organization or group:
   

• Select an organization and/or group from the Organization and Group lists. To clear filters, select All from the Organization and Group lists.
• Click X to exit.
  

6. (Optional) To view group details, click the down arrow to expand the group. Details display for each alert in the group. Alert details include:

• icon – Click to view related KB articles.
• Alert message (if available). Example: "In job queue (job #1216)".
• The date and time the alert was generated.
• Asset – Name of the protected asset (if available). Click to view asset details.
• Alert's X icon – Click to dismiss the alert.

7. The group's X icon displays above its list of alerts. Clicking this icon dismisses all alerts in the group. For details, see To dismiss a group of alerts.
   
8. Click the BackupIQ icon to close the Notifications list.
   

Use this procedure to dismiss a group of alerts. (To dismiss a single alert, click its X icon as described above in To view BackupIQ alerts.)

1. Log in to the UniView Portal with an account that has the Superuser or Admin role.
2. Click the BackupIQ icon in the upper-right corner. Alerts display.
3. Locate the group in the list and click its X icon. Click Confirm.
   

NOTE  Clearing an alert does not resolve the alert condition. If the alert condition still exists, a subsequent alert will be generated.

4. Click the BackupIQ icon to close the Notifications list.
   

Use this procedure to select and dismiss multiple alerts by organization and/or group.

1. Log in to the UniView Portal with an account that has the Superuser role.
2. Click the BackupIQ icon in the upper-right corner.
3. Click .
   
4. Select an organization from the Organization list and/or a group from the Group list.
5. Click Dismiss. Click Confirm.
   

NOTE  Clearing an alert does not resolve the alert condition. If the alert condition still exists, a subsequent alert will be generated.

6. Click the BackupIQ icon to close the Notifications list.
   

Use this procedure to dismiss all alerts. (To dismiss a single alert, click its X icon as described above in To view BackupIQ alerts.)

1. Log in to the UniView Portal with an account that has the Superuser or Admin role.
2. Click the BackupIQ icon in the upper-right corner. Alerts display.
3. Click Clear all, then Confirm to dismiss all alerts.
   

NOTE  Clearing an alert does not resolve the alert condition. If the alert condition still exists, a subsequent alert will be generated.

4. Click the BackupIQ icon to close the Notifications list.
   

Unresolved alerts display in the BackupIQ Notifications list. If you have integrated with a PSA system (BMS, Vorex, Autotask, or ConnectWise), a ticket is also generated in your PSA. Additionally, you may opt to receive email notifications for these alerts. Use these steps to set up email notifications:

1. Click :
   
2. On the Settings page, select the Alerts view.
3. Scroll down to Email Settings. Enter the email address and click Add Email. Repeat to add another address.
   
   Upon adding one or more email addresses, alerts are emailed to the specified addresses.
   Once the alert condition has been resolved, UniView Portal automatically removes the alert from BackupIQ and emails notification that the alert has been dismissed.

EXAMPLE  Sample offline and online email alerts:

Use this procedure to set alert thresholds against the last good backup and last good hot backup copy). A good backup or hot backup copy is one that finished with status success or warning. When a threshold is crossed, an alert is added to BackupIQ, enabling you to quickly prioritize and address alarm conditions:

• Global Thresholds (required) – Start by setting global thresholds for backups and/or hot backup copies. The global threshold settings you configure are applied to assets that are protected by a Unitrends backup schedule and do not have a custom threshold assigned. Global thresholds are applied across all organizations.
• Custom Thresholds (optional) – Create custom thresholds that you can quickly apply to one or more organizations. Custom thresholds take precedence over global thresholds.

Use these steps to configure conditional alarms:

1. Click the BackupIQ icon in the upper-right corner.
2. Click the icon.
   
3. Click to view global threshold settings for backups (Backups toggle) and hot backup copies (Replication Offsite toggle).
   
4. (Required) Enter Global Thresholds settings and click Save.

In this 4-hour example, a backup alarm is generated if a good backup does not complete within 4 hours of the job's scheduled start time. A hot backup copy alarm is generated if a good backup is not copied within 4 hours of the backup job's end time.

5. (Optional) Add a custom threshold and apply to organizations:

NOTE  Each organization can be assigned one custom threshold.

• Click + Create New:
  
• Enter a Title. Click to enable the Backups and/or Replication Offsite toggles. Enter threshold settings. Add one or more organizations. Click Save:
  
• The custom threshold is added:
  

When alarms are generated, they are added to the Notifications list in BackupIQ, as shown here:

View alarm details to determine root cause and next steps. These conditions are checked: appliance status, last good backup, backup job schedule, last good hot backup copy, and hot backup copy schedule. If there is an issue, an alert is generated.

Alarm details in the BackupIQ Notifications list:

Use these steps to view or modify conditional alarms:

NOTE  You must be logged in to UniView Portal as a superuser to create or modify conditional alarms.

1. Click the BackupIQ icon in the upper-right corner.
2. Click the icon.
   
3. (Optional) Modify Global Thresholds settings and click Save:
   
4. (Optional) Modify Custom Thresholds settings:

• Select the custom threshold.
  
• Modify the title or threshold settings.
• Add or remove organizations.
• Click Save.
  

You must be logged in to UniView Portal as a superuser to delete a custom threshold.

1. Click the BackupIQ icon in the upper-right corner.
2. Click the icon.
   
3. Select the custom threshold:
   
4. Review the organizations list. Organizations to which this custom threshold has been assigned display at the top of the list. Upon deleting the custom threshold, global thresholds are applied to any associated organizations.
5. Click Delete, then Confirm. The threshold is removed.
   

Conditional alarms can be configured to display as system alerts in your VSA 9 environment:

To add conditional alarms to your VSA 9 environment

NOTE  Alerts and conditional alarms are not yet supported for VSA 10 environments.

1. Ensure that these requirements have been met:

• Conditional alarms have been configured in the UniView Portal (as described in Conditional alarms).
• VSA 9 is running release 9.5.0.28 or higher.
• VSA is accessible on the Internet. If you have an on-premise VSA instance that does not have Internet access, UniView Portal cannot send conditional alarms to the VSA.
• These options are enabled in the VSA: Enable VSA API Web Service and Enable Third Party App Installation Globally. These options are located on the System > Server Management > Configure page:
  
• The roles and groups shown below are enabled. Enable these on the VSA System > User Security > User Roles page.
  

2. Add the VSA integration as described in Integrating VSA 9.

NOTES   

●    If you have already integrated an older VSA version, you must remove this integration, then add a new one using the latest TAP module. The Integrating VSA 9 procedure includes steps to remove the existing integration.

●   If the logos and branding you see in your currently deployed VSA module do not look like this new UniView module, you may be using a prior version of the TAP module for the Unitrends Backup Portal platform. As of January 2023, module branding has been modified, but no other functional changes exist. We do not recommend customers uninstall the older module to use the newer module as this will impact existing mappings (e.g., UniView user accounts mapped to KaseyaOne accounts for single sign-on, and assets mapped to VSA IDs).

3. Enable VSA alerts in the UniView Portal:

• In the UniView Portal, click :
  
• Select the Integrations view.
• Locate the VSA integration and click Show Configuration.
• In the Alerts section, click .
• In the VSA Alert Settings dialog, click the toggles to enable alerts for backups (Backups toggle) and hot backup copies (Replication Offsite toggle).
  

4. To finish the configuration, log in to the VSA and launch the UniView module.
   

NOTE  If prompted, enter your UniView Portal credentials and click Log in. Click Allow to grant UniView Portal access to the VSA instance.

Use this procedure to configure VSA email alerts for conditional alarms.

NOTE  Alerts and conditional alarms are not yet supported for VSA 10 environments.

1. Ensure that these prerequisites have been met:

• Conditional alarms have been configured, as described in Conditional alarms.
• Conditional alarms have been added to the VSA, as described in To display conditional alarms in the Kaseya VSA 9 Remote Monitoring and Management Solution.
• (On-premise VSA instance only) An SMTP server has been configured on the VSA System > Server Management > Outbound Email page. To configure an SMTP server, click Edit, enter settings, then click Save. Outbound Email fields include:

• Host Name – The name of the host email server. Example: smtp.mycompany.com. If no authentication or special port number is required, then only specify values for the Default Days to Keep Logs and Default Sender Email fields.

NOTE  Enter localhost in the Host Name field to use the Kaseya Server's IIS Default SMTP Virtual Server to route outbound email. The Default SMTP Virtual Server service must be installed and running in order to send email. The service must also be able to resolve DNS addresses to route email to other SMTP servers.

• Port – Typically 25, but the host email server may require a different port number. Ports 465 and 587 are typically used for connecting to an SMTP email server over SSL/TLS.
• User Name – If required for authentication, enter the username of an account authorized to use the host email server.
• Password – If required for authentication, enter the password of the account.
• Default Days to Keep Logs – Enter the number of days to keep log outbound email entries.
• Default Sender Email – Enter the default From address displayed by outbound email.
  

2. In the UniView Portal, click :
   
3. Select the Integrations view.
4. Locate the VSA integration and click Show Configuration.
5. Click to edit VSA integration settings.
6. Click New + in the Backups area to configure email alerts for backups or click New + in the Replication Offsite area to configure email alerts for hot backup copies.
   
7. In the Create New VSA Action dialog, select Email from the VSA Action list.
8. Enter one or more Recipient email addresses.

• You can enter addresses by typing or by using copy/paste keyboard shortcuts (Ctrl+C and Ctrlt+V).
• If entering multiple addresses, you must enter a comma or space between each address.

9. Click Confirm.
   
10. The Email alert is added.
    

NOTE  VSA Actions are user specific. The email alert that you added displays for your user account only. If another user logs in to the UniView Portal, the VSA Actions that were added by your user account do not display. Because of this, it is possible that another user may create a duplicate VSA action.

11. (Optional) Repeat this procedure from Step 6 to add email alerts to the other job type.
12. Click Done to exit.
    An email alert is sent if the conditional alarm threshold is reached. Sample conditional alarm email alert:
    

1. In the UniView Portal, click :
   
2. Select the Integrations view.
3. Locate the VSA integration and click Show Configuration.
4. Click to view or edit VSA integration settings.
   
5. Click Email to view or edit the VSA action.
6. (Optional) Add or remove Recipient email addresses, then click Confirm. Click Done to exit.

• You can enter addresses by typing or by using copy/paste keyboard shortcuts (Ctrl+C and Ctrlt+V).
• If entering multiple addresses, you must enter a comma or space between each address.
• To delete an email address, click its X.
  

1. In the UniView Portal, click :
   
2. Select the Integrations view.
3. Locate the VSA integration and click Show Configuration.
4. Click to edit VSA integration settings.
   
5. Locate the Email conditional alarm in the Backups area or the Email conditional alarm in the Replication Offsite area (for hot backup copies). Click its X to remove the email alert. Click Done to exit.