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:
|
| Level |
This applies to the seriousness of the issue. If a metric is activated you can set the message given as:
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:
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:
|
| 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:
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:
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:
|
| 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:
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. |