Cato Networks Knowledge Base

Search

Working with Link Health Rules

This article discusses how to configure health rules to generate events and email notifications for connectivity or link quality issues.

Overview of Health Rules

Use the Health Rules screen to configure the Cato Management Application to send email notifications when there are events related to link connectivity or quality during the configured amount of time. For connectivity rules, you can define the scope for objects that trigger an event for connectivity issues. For quality rules, define the objects that are monitored for link quality threshold on one or more interfaces. In addition, you can select which types of quality categories trigger events.

Managing Health Rules

The following sections explain how to create, enable, and manage health rules.

Configuring a Connectivity Health Rule

You can set conditions for the rules (such as only send an alert if the issue persists for a specific duration or if the issue occurs repeatedly), as well as set different rules for one or more connectivity event (such as failover, passive disconnect, disconnect).

For connectivity health rules that include sites, we recommend that you do not use the Any option. Sites can generate many events or notifications, because users and groups are regularly disconnecting and connecting.

ConnectivityHealthRule.png

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 toggle.png to make sure that the rule is enabled.

  4. Configure the Source settings for the rule:

    1. Select the type (for example: site or user).

    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 Event, select one or more connectivity events that trigger the rule:

      • Any - Any type of connectivity event

      • Failover - Failover between primary and secondary links, or vice-versa.

      • Primary Disconnect - Link(s) in active state disconnected.

      • Secondary Disconnect - Link(s) in passive state 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)

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

      • For disconnect conditions, you can define the time Duration that the link or connection is disconnected before triggering the rule.

      • In Occurrences, you can define how often the connectivity issue occurs before triggering the rule.

      Note

      Note: The Limits settings are evaluated as an OR relation.

  6. In Tracking, configure the Event and Email Notifications for this rule. (see below Configuring Tracking Options)

  7. Click Apply. The new rule is added to the rulebase.

  8. Click Save. The Connectivity Health rules are saved to your account.

Monitoring Link Quality with Health Rules

Quality Health Rules let you monitor the link quality between the site and the Cato Cloud. When the quality does not meet a threshold during the configured time frame, the Cato Management Application sends an email notification. A second email is sent after the link quality returns to comply with the threshold for a specific time period.

You can define the scope of a rule for specific sites or groups. In addition, define which links are monitored for interfaces on sites with sockets and IPsec connections. You must configure at least one quality threshold to trigger an email alert according to these categories:

  • Packet Loss (percentage of transmitted packets)

  • Distance (milliseconds that it takes a packet to travel between the socket and the PoP)

  • Jitter (delay in milliseconds between packets)

  • Congestion

  • Traffic that is upstream, downstream, or both

When you select more than one quality threshold, they are evaluated with an OR relationship.

Configuring a Link Quality Health Rule

Configure a quality health rule to monitor the quality of the links between sites and objects in your account and the Cato Cloud.

QualityHealthRule.png

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 toggle.png to make sure that the rule is enabled.

  4. Configure the Source settings for the rule:

    1. Select the type (for example: site or user).

    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.

    Note

    Important! For connections that use IPsec, you must select Any. Otherwise, the quality rule does not monitor the link quality.

  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 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. In Tracking, configure the Event and Email Notifications for this rule. (see below Configuring Tracking Options)

  8. Click Apply. The new rule is added to the rulebase.

  9. Click Save. The Quality Health rules are saved to your account.

Configuring Tracking Options

The Track option lets you create alerts that are triggered by different rules, such as firewall rules, remote port forwarding rules, health alerts and more. For some rules, such as firewall rules, you can choose to generate events when the rule is matched.

The Frequency defines how often notifications can be generated by the system. Each occurrence only generates a single alert.

To configure tracking an event:

  1. In the Tracking section, click Event. The event is enabled. You can trigger email notifications to alert you when the rule is applied.

  2. Click Email Notification, which lets you configure the frequency and select the mailing that is notified when the event is triggered.

  3. In the Frequency section, configure how often an email is sent to the recipients as follows:

    • Immediate - an email is sent to the recipients for every occurrence.

    • Hourly - an email is sent to the recipients with the first occurrence, and if there are any additional occurrences, then the next email for any additional occurrences follows after 1 hour.

    • Daily - an email is sent to the recipients with the first occurrence, and if there are any additional occurrences, then the next email for any additional occurrences follows after 24 hour.

    • Weekly - an email is sent to the recipients with the first occurrence, and if there are any additional occurrences, then the next email for any additional occurrences follows after 1 week.

  4. Select a Mailing List whose members receive the alerts, or create a new mailing list by clicking New and defining the name and recipients of the new group.

  5. Click Apply. The event is added.

  6. Click Save. The event is saved.

Enabling and Disabling Health Rules

To enable or disable a rule:

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

  2. On the right of the rule, click the icon More_icon.png and from the pop-up menu select Enable or Disable.

  3. Click Save. The rule is enabled or disabled.

Deleting Health Rules

You can delete one or more health rules. After you delete the rules, you cannot undo or restore them.

To delete one or more health rules:

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

  2. Click the icon More_icon.png and from the pop-up window select Delete Rule.

  3. In the confirmation window, click Delete Rule. The rule is removed.

  4. Click Save. The rule is deleted.

Was this article helpful?

1 out of 1 found this helpful

Comments

1 comment

Date Votes
  • Comment author
    Rhys Goodwin 
    Select one or more Thresholds, and configure the quality value for each threshold.

    Is this an AND or an OR condition? 

    0

Please sign in to leave a comment.