Follow our expert Miyamta, as she creates a new Watcher and walks us through its various elements.
Creating a Watcher
Navigate to the Watchers section of the platform, located under the 'Optimise' tab.
To create a new watcher, click the 'New Watcher' button, then enter a name and select the relevant site. Click 'Create Watcher.'
This creates the watcher and then opens the watcher configuration screen.
Configuring a Watcher
The Watcher configuration screen is split into three sections; General Properties, Task Details and Watcher Settings.
General Properties
The General Properties section allows you to configure the following for the Watcher.
Watcher Name: The name given to the Watcher. This is also the name given to the Tasks the Watcher creates.
Status: Defaults to 'on,' ensuring that email alerts are sent when the Watcher conditions are met.
Site: The site associated with the Watcher, chosen in the previous screen.
Description: This should describe the purpose of the Watcher, and the fault it has been created to identify.
Event Details
The Event Details section allows you to configure the following for the Events created by the Watcher when it fires.
Impact: A datasource which quantifies the impact of the event in any quantity.
Cost: A datasource which quantifies the cost of the event in a currency.
Category: Selects the Event category, if known.
For further information on Events, please click here.
Task Details
The Task Details section allows you to configure the following for the Task created by the Watcher when an event happens.
Notify: Toggle to 'on' to notify users of the task by email.
Assignee: Designates the user responsible for Tasks generated by the Watcher.
Subscribers: Adds additional users who should also receive tasks.
For further information on Tasks, please click here.
Watcher Settings
The Watcher Settings control the conditions for triggering the Watcher. This also displays the user who most recently updated the Watcher. A Logic Group must be created before a Watcher can be saved.
There as two types of logic groups provided in CoolPlanetOS, Simple Logic Groups an Advanced Logic Groups.
Simple Logic Groups
Simple logic groups are are a simplified form of logic group which allow the user to set simple thresholds, above or below which the watcher will fire. This allows users to create a simple watcher that fires when a datasource being watched goes above or below a number, for example if a production output number falls below a set mass, or a temperature goes above a set limit.
To create a simple logic group, the user first selects a datasource to monitor, then they select the time range and the fold, then they set the threshold(s) to base the alerts on before finally setting the number of consecutive occurrences that should occur before the watcher fires.
There are five ways the thresholds can be configured in the simple logic group UI.
Only the "Below" value is set: In this case the watcher will fire if the datasource value drops below the specified "Below" value.
Only the "Above" value is set: In this case the watcher will fire if the datasource value raises above the specified "Below" value.
The "Below" value is less than the "Above" value: In this case the watcher will fire if the datasource value goes outside of the range set by the "Below" and "Above" value. This is useful if you want to ensure a temperature of an asset stays within a specified range.
The "Below" value is greater than the "Above" value: In this case the watcher will fire if the datasource value goes within the range set by the "Below" and "Above" value. This is useful if you want to set a "Forbidden range" that the value should not enter into.
The "Below" value and "Above" value are set the same: In this case the watcher will fire if the datasource value is different to the value set in the Below and Above fields. This is useful if you want to ensure a set point on a piece of equipment is not changed.
Advanced Logic Groups
Advanced logic groups allow for complex logical statements to be evaluated based on a range of datasource values. The following is how these advanced logic groups can be defined:
Define the minimum time before the Watcher event is triggered by selecting an option in the dropdown.
Click on the '+' icon to add a new condition to the logic group
All conditions must be compared against Datasources.
Select the relevant Datasource for the monitored equipment. The condition will default to the appropriate fold where relevant, otherwise a fold can be selected.
Select the comparison type needed in the centre field. This defaults to 'equals.'
If the comparison Datasource is already present, select this from the next Datasource field.
Otherwise, add the new Datasource, by clicking 'Datasources' at the top of the screen, to open the Datasource drawer.
Within this drawer, click 'Add New Datasource.'
A constant or calculated datasource can be created. In this example, we are creating a constant of 1000kWh.
After creating the Datasource, close the Datasource drawer to return to the logic group panel, then select the newly created Datasource from the list.
For further information on Logic Groups, please click here.
4. Save your Watcher
Once this has been added, the 'Save Watcher,' button becomes enabled, allowing you to save the new Watcher.
