Working with Link Health Rules

To configure a Connectivity Health Rule:

1. From the navigation menu, click Network > Link Health Rules.

2. From the Connectivity Health Rules tab or section, click New.

   The New Connectivity Health Rule panel opens.

3. Configure the General settings for the rule:
   1. Enter a Name for the rule.
   2. Click the slider to make sure that the rule is enabled.
4. Configure the Source settings for the rule:
   1. Select the type (for example: site or group).
   2. When needed, select a specific item from the drop-down list for that type.
5. Configure the Condition settings (the On column) for this rule:

   1. In On, select one or more connectivity items that trigger the rule:

      • Any - Any type of connectivity issue
      • Failover - Failover between primary and secondary links, or vice-versa.
      • Active WAN Link Disconnect - Link(s) in active state disconnected.
      • Passive WAN Link Disconnect - Link(s) in passive or last resort state are disconnected.
      • Socket Failover - Failover between Sockets in HA configuration.
      • Internet as a Transport - Disconnection for links transporting data over the Internet (and not the Cato Cloud).
      • LAN Port Disconnect - A LAN port is disconnected.
      • Alt. WAN Disconnect - Link used for recovery via Alt. WAN is disconnected.
      • HA Not Ready - One of the Sockets in an HA configuration is disconnected or both Sockets report as the primary Socket.

   2. In Alert Upon, you can define the time duration or number of connectivity issues that trigger the rule:

      • For disconnect conditions, you can define the Link Down Duration - the time that the link or connection is disconnected before triggering the rule.
      • In Event Occurrences, you can define how often the connectivity issue occurs before triggering the rule.

      Note

      Notes:

      • The Alert Upon settings are evaluated as an OR relation.

      • By default, the health rule engine checks for a duration of 2.5 minutes to determine if an event matches a rule. If you configure a Link Down Duration for the rule of less than 2.5 minutes, this can impact the content of the notification. For example, if a Duration of 1 minute is configured for an Active WAN Link Disconnect rule, then the rule will be matched after the active link is disconnected for 1 minute. But this can result in two different notifications, as follows:

        • If the active link is disconnected for more than 1 minute and remains disconnected for more than 2.5 minutes - the notification will be for a Disconnect
        • If the active link is disconnected for more than 1 minute, but reconnects before 2.5 minutes - the notification will be for a Connect alert (the event related to the alert may also appear as a PoP Change or Reconnect event)
      • When Occurrences are set for a disconnect rule (e.g. Active WAN Link Disconnect or Passive WAN Link Disconnect), PoP changes and session reconnects are not counted as occurrences. Only disconnects are counted.
      • When alerts are triggered by Occurrences conditions in an Active WAN Link Disconnect or Passive WAN Link Disconnect rule, a Connected alert will not be sent when the link is back up

      • When the Condition is set for Active WAN Link Disconnect or Passive WAN Link Disconnect, the rule sends a Connected alert after the link is back up for 30 seconds in the following cases:

        • There are no Alert Upon conditions set
        • If only a Link Down Duration condition is set

        • If both Link Down Duration and Event Occurrences conditions are set, as follows:

          • If the Link Down Duration condition triggers an alert, a Connected alert will be sent when the link is back up for 30 seconds
          • If the Event Occurrences condition triggers an alert, a Connected alert will not be sent when the link is back up

6. (Optional) Configure the Tracking options to Send Notification.

   For more information about notifications, see the relevant article for Subscription Groups, Mailing Lists, and Alert Integrations in the Alerts section.

7. Click Apply. The new rule is added to the rulebase.
8. Click Save. The Connectivity Health rules are saved to your account.

To configure a Health Rule to monitor the link quality:

1. From the navigation menu, click Network > Link Health Rules.

2. From the Quality Health Rules tab or section, click New.

   The New Quality Alert panel opens.

3. Configure the General settings for the rule:
   1. Enter a Name for the rule.
   2. Select the traffic Direction that triggers the rule: Any, Upstream, or Downstream.
   3. Click the slider to make sure that the rule is enabled.
4. Configure the Source settings for the rule:
   1. Select the type (for example: site or group).
   2. When needed, select a specific item from the drop-down list for that type.

5. In the Network Interface section, select one or more interfaces for the rule.

   To apply the rule to all the interfaces, select Any.

6. In the Condition section, define the link quality conditions that trigger the rule:
   1. Select one or more Thresholds, and configure the quality value for each threshold.
   2. Define the Link Down Duration settings for how long the quality issue for the link continues.
   3. In Clear Event, set how long to wait before sending the All Clear email notification.

7. Configure the Tracking options to Send Notification.
   Note: If the Send Notification option is disabled, the rule does not generate notifications or events.

   For more information about notifications, see the relevant article for Subscription Groups, Mailing Lists, and Alert Integrations in the Alerts section.

8. Click Apply. The new rule is added to the rulebase.
9. Click Save. The Quality Health rules are saved to your account.