The Active Events page lists all events that are automatically generated by the software (based on some user defined alert triggers configured in the administration) or manually added by the user. These events should represent anomalies that are happening or that occurred in the network, and should be managed by the user. For more information about events management workflow. please click here.
The generated alerts can be triggered using the sensor pattern as reference, or can be based on absolute sensor values defined by the user. All trigger configurations are defined by the user at the alerts administration page. For some tips how to configure bursts alerts, please see this article. If you want to know more about pipe break event workflow in WaterSight, click here.
Important note: Once the anomalies represented by those events are finished (or in case they are false positives), the user should make sure he updates the status to Closed (or deletes), so that the Active Event List will be always showing the most recent alerts that are still Active.
It is also possible to manually add an event, by clicking in the "Add" button just above the alerts list. This is particular useful to track events that are happening or occurred in the network, but were not automatically generated by the software. The "Edit" and "Remove" buttons located above the table also allow the user to edit existent alerts as well as delete a specific alert (in this case only administrators have permission to delete alerts). To edit or delete a specific alert, select first the row that contains the alert, and then click on the edit or delete button.
The user can also directly add manual events directly from the sensor or zone graphs, by clicking on the button "Create Event" located on the right side.
Figure 1 - Add a manual event directly from the graph by clicking in the "Created Event button" located on the right side
The search field allows the user to search for a specific alert or groups of alerts based on their name/ID.
The user can download the list of alerts and all the respective details to CSV for further analysis.
The active events table lists by default all events that are open and that require user attention, ordered by date, this means that most recent events will appear first. Closed events will not be displaying by default in the table, but the user can use the status column filter to search for those specific events. In the list there is also a mini-graph view that allows the user to easily and quickly identify and understand each event.
In case the sensor/zone values are still outside the thresholds defined in the Alerts administration page (for pattern type alerts this means still outside the pattern confidence bands; for absolute type alerts means still above or below the absolute threshold defined) a red message will be displayed informing that the event is still in progress (see figure below).
Name of the alert. If the alert was automatically generated by the software, this field is blocked for editing, and the default name will follow the rule “Alert + ID”. If the alert was manually added by the user, the default name will be “User-defined”, but the user can change it.
Click on the symbol located on the right of the Status to see all filter options.
By default the list of alerts is showing all alerts that are open and that require user attention. This includes the alerts with the following status: New, Under Investigation, Field Work and Open (all status except Closed). Once an alert is closed, it will be hidden from the default view list, and the user will need to check the “Closed” status from the status table available and located on the right side. The user can also search for specific alerts in the list based on one or more selected status.
Click on the symbol located on the right of the Category to see all filter options.
The user can filter the alerts that are being displayed in the list based on the selected category: Unknown, Meter Failure, Burst, Leak, Flow Increase, Maintenance Work, Zone Change or show all categories.
For more information, see below, under Event Properties section.
This easily identifies the reason why the alert was generated. The symptom is identified based on the user admin configurations defined in the alerts configuration page:
For alert types "Pattern" and "Absolute":
For alert types "No Data" and "Flat Reading":
Origin: Sensor or zone which the time series that generated the alert belongs to. For more information about the difference between triggering alerts for zones vs sensors, please click here.
Extreme value: Maximum or minimum value registered by the sensor/zone (depending if alert type is high or low). This value is automatically calculated by the software for automatically generated alerts. For manually added alerts, this field must be manually completed. For pattern based alarms (please see alerts configuration page for more detail), this corresponds to the burst (or event) flow, and it is given by the maximum difference obtained between the sensor real value and the pattern. For absolute based alarms (please see alerts configuration page for more detail), this corresponds to the maximum absolute value registered by the sensor (within the period of the event).
End date: end date of the event. For pattern based alerts (please see alerts configuration page for more detail) it is when the event returns to the pattern. For absolute based alerts (please see alerts configuration page for more detail) it is when real values are below (for high type) or above (for low type) the absolute numerical value defined by the user in the alerts configuration. In case the event is still out of the patterns or still above or below the absolute threshold value defined, then it will appear "In progress".
Mini-graph view of the event.
Map: will directly jump to the sensors status or zone status map.
Edit: will directly jump to the event details page.
Delete: will delete the event.
Changes to the event (changing name, status, category, making comments, etc) are made through the right side panel. For that the user needs to first select in the Active Events table the row (event) he wants to edit.
Same as described above, in the Active Events table section.
Status of the event. The user should update status according with the respective events workflow:
The user has the option to filter the events that appear on the list. By default the list is always showing all alerts/events that are in progress (this means all alerts that are not closed).
Whenever an alert is generated, the category is always set to unknown, expect if the alert type (configured in the Alerts Administration page) was set to "No Data" or "Flat Reading". In these two last cases, the default category of the event generated is Meter Failure.
After the cause of the event was identified, the user must select the most appropriate field defined in WaterSigth: Unknown, Meter Failure, Burst, Leak, Flow Increase, Maintenance Work, Zone Change. Maintenance work includes all operational works developed in the network (flushing, opening/closing valves, etc). Zone Change refers to a temporary or permanent change of the zone layout (by opening/closing valves)
The date the event started (and not the date the alert was triggered). As illustrated in figure below, the alert is generated when the trigger configurations defined by the user in the alerts configuration page are met, however the real event can already have started some hours earlier.
Figure 1. Difference between event start date and date the alert was triggered, for a pattern based alert.
End date of the event, for which the alert was triggered. For pattern based alerts (please see alerts configuration page for more detail) it is when the event returns to the pattern. For high type alerts this means below percentile 80th (values are color coded with a black circle). For low type alerts this means above percentile 20th (values are color coded with a black circle). For absolute based alerts (please see alerts configuration page for more detail) it is when real values are below (for high type) or above (for low type) the absolute numerical value defined by the user.
Figure 2. Start date and End Date for a pattern based alarm.
The duration of the event is automatically calculated by the software using the Start Date and End Date (for automatically generated alerts). For manually added alerts, this field must be manually completed.
Figure 3. Duration of the event.
Volume lost in anomalies and other events (like bursts, leaks, flushing, fire usage, etc). This volume is automatically calculated by the software for automatically generated alerts, and only for alerts that were generated based on a flow time-series using pattern high as a criteria (please see alerts configuration page for more detail).
The volume is automatically calculated by integrating the difference between real flow and expected flow (the pattern) along time, for the all duration of the event.
Figure 5. Identification of the lost volume.
The user has the ability to control if an event should be considered for the pattern and forecasts calculations of the sensor or if should be ignored. Generally all alerts that represent anomalous or extraordinary events (such as bursts, leaks, fires, tank overflows, temporary zone changes) should not be considered for the pattern calculations and forecasts of the respective sensor. In these cases the option "Remove From Patterns" should be checked .
By default the alerts types configured as No Data or Flat Reading (configured in the alerts administration) will automatically generate events that will have the option "Exclude From Patterns" enabled (this means that meter failure periods are automatically not considered for the pattern calculation). All other alerts type (pattern and absolute) will generate events that will have the option "Exclude From Patterns" disabled (meaning that those periods will be considered for future pattern calculation) as starting point. However, once an event is correctly categorized, this option will be automatically updated:
The user has always the option to override these defaults by manually changing these settings in the Event Properties table, in the Active Events page, by checking or unchecking the Exclude From patterns option.
Please note that if an anomalous (extraordinary) event has occurred and the "Exclude From Pattern" option is unchecked (or either because the user did not categorize the event or because he wrongly overrided the defaults), those values related to the anomalous events will be considered for the future patterns calculations and forecasts, and with this "polluting" the patterns. For more information please take a look at this article.
The user can update the event with some relevant comments (for example the type of burst, location, and other relevant information for the utility).
Displays the information related with the configurations of the trigger that generated the alert. Those configurations are defined in the Alerts administration page.
Defines the method that is used to evaluate the alert criteria. The user can define 4 different types of alerts: Pattern, Absolute, No Data and Flat Reading. More information in the Alerts administration page.
The user picks High or Low to indicate if the trigger is a high or low alarm. More information in the Alerts administration page.
The user defines the real time series where all trigger configurations will be assessed. Available options are the 15 minutes time series, the daily minimum series and the daily average series. More information in the Alerts administration page.
This option is only available for pattern based alerts. The user can choose the time period that will be used to serve as reference to generate the alerts. More information in the Alerts administration page.
The user defined value from which an alarm can be automatically generated. More information in the Alerts administration page.
It defines the minimum number of consecutive outliers needed to generate the alarm. More information in the Alerts administration page.
For more information about WaterSight, please go to OpenFlows WaterSight TechNotes and FAQ's.