Control rules

Control rules for monitoring

Within ConnectPlaza Control you can define rules to monitor your ConnectPlaza Environment. These rules are used within the ConnectPlaza Monitor to give you a way to proactive monitor your ConnectAgents.

Per default, there are some rules available. When you first enter ConnectPlaza Control, open your ConnectAgent and check the menu option All rules to see them.

You see the following information on this grid:

Column Description
Location This is the location the rule applies to. A location is a part of the ConnectAgent you want to check.
Check Interval This is the CRON expression to set the interval for the monitor to check this location.
Type

Type of then rule, this can be one of the following types:

  • Single metric
  • Stationary metric
  • Multi metric (not changeble at the moment)
  • Timed trigger metric
  • Timed trigger multi metric (Not changeble at the moment)
  • Changed metric
Level

This applies to the seriousness of the issue. If a metric is activated you can set the message given as:

  • WARNING
  • ERROR
  • INFO

The ConnectPlaza Monitor will react accordingly to this state.

Message The message returned by the ConnectPlaza Monitor
Open the rule set to modify this rule.

Creating and modifying rules

When you open one the rule editor via one of the or buttons in the ConnectPlaza Control application you will be presented with the following screen:

If you have selected a property with a rule in place, you will see the rule in this screen. Above example has no rules attached yet.

The first step to create rule is to define the Check interval. This is a cron definition you can create with the Cron editor. Use the button to open the Cron editor.

If you have selected the right interval, select the Set button to use the selected cron definition.

Select one of the rule templates, via the buttons at the bottom of the dialog. For instance Single metric. This will look like this.

Now you can modify the values on this screen and save the rule.

You can add multiple rule templates for one metric. They will be executed at the selected interval.

Rule templates

The template determines which validation is done with a metric to decide whether or not to send a notification.

The following rule templates are available:

Type Description
Single metric Test the value of the metric against the given (static) value with the given condition. If true, a notification will be send
Stationary metric Test the value of the metric over time. If the value is not changed in the given time period, a notification will be send.
Timed trigger metric Delays the notification when the trigger occurs, forgetting about it when the trigger doesn't happen anymore before the and of delay. Sends one notification, and another when the trigger doesn't happen anymore.
Changed metric Test the value of the metric over time. If the value is changed a notification is send.

Single metric

Purpose: Test the value of the metric against the given (static) value with the given condition. If true, a notification will be send.

Field overview:

Fieldname Description
Active Is this rule active of inactive. You can select the button to change the value. Active (orange) is default.
Notification level

This applies to the seriousness of the issue. If a metric is activated you can set the message given as:

  • WARNING
  • ERROR
  • INFO

The ConnectPlaza Monitor will react accordingly to this state.

Message Message to return to the client
Rule priority

Number between 1 and 99. When more than one metric notification is defined on one metric for this template, this defines the priority of the rule.

Trigger condition

Test the value of the property against the value of the rule based on the condition. The following conditions may be applied:

  • ==        -- Equal to
  • >          -- Greater than
  • >=        -- Greater or equal to
  • <          -- Less than
  • <=        -- Less or equal to
  • !=         -- Not equal to
Trigger value Given static value to test against.

Stationary metric

Purpose: Test the value of the metric over time. If the value is not changed in the given time period, a notification will be send.

Field overview:

Fieldname Description
Active Is this rule active of inactive. You can select the button to change the value. Active (orange) is default.
Notification level

This applies to the seriousness of the issue. If a metric is activated you can set the message given as:

  • WARNING
  • ERROR
  • INFO

The ConnectPlaza Monitor will react accordingly to this state.

Message Message to return to the client
Rule priority Number between 1 and 99. When more than one metric notification is defined on one metric for this template, this defines the priority of the rule.
Trigger delay period in seconds Time period in seconds

Timed trigger metric

Purpose: Delays the notification when the trigger occurs, forgetting about it when the trigger doesn't happen anymore before the and of delay. Sends one notification, and another when the trigger doesn't happen anymore.

Field overview:

Fieldname Description
Active Is this rule active of inactive. You can select the button to change the value. Active (orange) is default.
Notification level

This applies to the seriousness of the issue. If a metric is activated you can set the message given as:

  • WARNING
  • ERROR
  • INFO

The ConnectPlaza Monitor will react accordingly to this state.

Message Message to return to the client
Notification resolved message The notification message when the trigger is resolved. Only send when message was send earlier.
Rule priority Number between 1 and 99. When more than one metric notification is defined on one metric for this template, this defines the priority of the rule.
Trigger condition

Test the value of the property against the value of the rule based on the condition. The following conditions may be applied:

  • ==        -- Equal to
  • >          -- Greater than
  • >=        -- Greater or equal to
  • <          -- Less than
  • <=        -- Less or equal to
  • !=         -- Not equal to
Trigger delay time in seconds Time to delay the notification.
Trigger value Given static value to test against.

Changed metric

Field overview:

Fieldname Description
Active Is this rule active of inactive. You can select the button to change the value. Active (orange) is default.
Notification level

This applies to the seriousness of the issue. If a metric is activated you can set the message given as:

  • WARNING
  • ERROR
  • INFO

The ConnectPlaza Monitor will react accordingly to this state.

Message Message to return to the client
Delta value Difference with previous value for notification to be send.
Rule priority Number between 1 and 99. When more than one metric notification is defined on one metric for this template, this defines the priority of the rule.