Conditional alarms

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.
  

NOTE  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 inConditional 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.