Alarm management - XWiki Eniris Smartgrid One

= **Introduction** =

(((

An alarm configuration can be set for each measuring point in the EMS. There are 3 types of alarms available as standard: Low Threshold, High Threshold, and Offline. The Custom alarm type is a feature that is not activated by default.

)))

(((

)))

(((

By default, alarm management is shown for all user types: super admin, admin, installer, and user. It is possible to hide this part.

)))

(((

)))

(((

You must set an alarm configuration for a measuring point. The evaluations of an alarm configuration are set via “alarm” in the left menu. You need a configuration and an evaluation to receive alarm emails

)))

== **The alarm configuration of a measuring point** ==

25

26

(((

27

At the measuring point level we must clearly define the time series, choose the types of alarms, and set associated parameters.

)))

== **Data** ==

(((

Type of time series: If the measuring point concerns a counter reading, then "Show counter reading as counter reading" must be selected here. The alarm configuration can handle any type of time series, but there are certain situations that can cause problems:

)))

(((

)))

(((

Data that arrives with a delay (e.g. Fluvius or Ores data) has an alarm configuration that ideally is not evaluated during the period in which data is absent. This makes it impossible to evaluate such data points in real time, but a delay can be used (“max duration of no data or delayed data”).

)))

(((

)))

Data that arrives irregularly

49

50

[[image:1694469998758-831.png||height="165" width="547"]]

51

52

(((

53

**Aggregation**: here you can choose whether the average value or the real-time value is evaluated. Please note: the average value corresponds to the field that is filled in under “field_mean” at a measuring point and the real-time value corresponds to the field that is filled in under “field” at a measuring point.

)))

(((

)))

(((

**PLEASE NOTE: if you work with an aggregate (a measuring point that has a field preceded by mean_), this aggregate is available with a delay. E.g. a generator that is averaged from 4:45 PM to 5:00 PM may sometimes be available at 5:01 PM or 5:10 PM. Depending on how busy the server is, a generator will be calculated sooner or later. That is why setting alarms on generators is risky.**

)))

__Considered time interval:__

67

68

(((

69

This is the interval in which a counter reading is evaluated, starting from the evaluation moment. Since we work with an interval, this only applies to meter readings. If the alarm management evaluates with a frequency of 5 minutes (to be set later) and the interval considered is 15 minutes, then the following example applies:

70

)))

71

72

17:00, beschouw het interval van 16u45 TOT 17u00. If there is a measuring point every minute, then these are 15 measuring points that are considered.

.

(((

**PLEASE NOTE: if you work with an aggregate (a measuring point that has a field preceded by mean_), this aggregate is available with a delay. E.g. a generator that is averaged from 4:45 PM to 5:00 PM may sometimes be available at 5:01 PM or 5:10 PM. Depending on how busy the server is, a generator will be calculated sooner or later. That is why setting alarms on generators is risky**

)))

(((

)))

(((

**It is also for this reason that “Last 15 minutes - only for real-time data” is explicitly stated that this is only for real-time data!**

86

)))

87

88

[[image:1694470028060-449.png||height="208" width="478"]]

== **Alarm Type** ==

You can raise an alarm on:

96

97

* (((

98

The absence of a measuring point for a period of X minutes. A zero value does not mean that a measuring point is absent.

)))

* (((

Exceeding a maximum.

)))

* (((

Falling below a minimum

)))

(((

**NOTE: The units must be respected (W or minutes).**

)))

== **The alarm window** ==

(((

This is the interval within which the evaluation of alarm configurations takes place. Outside this interval, the alarm configuration will enter the “hibernate” status.

)))

(((

)))

(((

The alarm severity is currently a feature that is not active by default.

)))

This has been updated with extra functionality. You can now choose to keep state or reset state. This means that if a window is set it will resend your alarm every day if it gets triggered again. If you decide to keep the state it means it will not resend the alarm tomorrow if it was triggered yesterday.

131

[[image:1716984443911-429.png]]

132

133

== **Monitored Data Points** ==

134

135

136

this is a status table that shows for a given measuring point:

137

138

* whether a maximum has been set(not active here),

139

* a minimum is set (active here and 0W),

140

* the absence of a measuring point

* the observed value

(((

The observed value can also be seen in a graph at the bottom of the page.

)))

[[image:1694470086669-261.png]]

149

150

151

== **Evaluations** ==

152

153

(((

154

After an alarm configuration has been assigned to one or more measuring points of a building, you must have the alarm configurations evaluated and actions defined for this building.

)))

(((

)))

(((

To do this, go to “alarms” in the left menu, go to “Evaluations per type of alarm per building” and choose “ADD”.

)))

[[image:1694470104776-249.png]]

(((

Measuring points of the type “low threshold” or “offline” or “high threshold” or “custom” are bundled (evaluated together and actions taken together).

171

)))

172

173

[[image:1694470118141-727.png]]

174

175

(((

176

E.g. above, all cases where a threshold value is exceeded at the measuring points of a building are bundled.

)))

(((

)))

(((

Under “Owned by”, enter either the super admin or the admin level of a building. A super admin then has the option to evaluate multiple buildings.

)))

[[image:1694470125741-939.png]]

189

190

(((

191

Once the evaluation has been created, we need to further configure it. Click on the gear.

)))

== **Frequency** ==

(((

By frequency, we mean the rate at which an alarm configuration for the group of measuring points is evaluated. For example, if we choose 5 minutes, the alarm configurations of the measuring points that fall under the monitored object (the monitored building) with the previously specified alarm type are evaluated every 5 minutes.

)))

[[image:1694470145009-530.png]]

203

204

205

== **Monitored objects** ==

206

207

(((

208

With this, we indicate the role of a building (e.g. Building – Admins) for which we wish to monitor the measuring points of the previously specified alarm type

)))

(((

**Please note**: please select one object.

)))

[[image:1694470158674-242.png]]

== **Evaluation** ==

(((

This button is not yet completed but is not critical to the operation

)))

== **Actions** ==

(((

Here you can link actions to the status of alarm configurations after evaluation. Multiple actions can be set per status. There are two alarm statuses: the alarm is active or the alarm is inactive.

)))

[[image:1694470186018-661.png]]

* (((

With "status duration" you can set how long the status should be active before the action is executed. E.g. send an email after the evaluation of the alarm configuration 3600s was positive.

238

)))

239

* (((

240

Receivers: by setting a full contact list, a reference is made to the email recipients in the alarm section at the measuring point level. By choosing fixed you can manually specify the email recipients on the same screen.

241

)))

242

* (((

243

"Language" should be set to Default by default.

244

)))

245

* (((

246

Subject and Content: This can be set according to the syntax described in email templates.

247

)))

248

249

[[image:1694470196877-756.png]]

== **Email templates** ==

254

255

(((

256

Here you can link actions to the status of alarm configurations after evaluation. Multiple actions can be set per status. There are two alarm statuses: the alarm is active or the alarm is inactive

)))

(((

Below you will find some email templates.

)))

=== Subject ===

(((

Please enter a text that specifies which site and type of alarm it concerns, e.g.: "Site Eniris - High Threshold Alarm"

)))

(((

)))

(((

Indiction which measuring point is involved is only possible if the site only contains one measuring point to be monitored

)))

=== Body Templates ===

280

281

**Site X - High Treshold Alarm**

282

283

284

**Site X - High Treshold Alarm**

Hallo,

Er is een nieuw alarm opgetreden!

289

290

Wanneer?

291

Storing opgetreden op: {{#formatInTimeZone}}{{date}},Europe/Brussels,yyyy-MM-dd HH:mm{{/formatInTimeZone}}

292

Wat?

293

<ul>

294

<ul>{{#points}} Object: {{site}} - {{name}} met als waarde: {{value}} overschrijdt de maximale waarde: {{maxValue}}</ul>

</ul>

<ul>{{/points}}</ul>

Zolang het alarm actief is, wordt een herinnering verstuurd om de 2.0 uur. Om dit interval aan te passen, of de overwaking uit te zetten, dient u naar de alarminstellingen te navigeren.

Kind regards

**Site X - Herstel High Treshold Alarm**

Hallo,

Er is een alarm hersteld!

309

310

Wanneer?

311

Herstel opgetreden op: {{#formatInTimeZone}}{{date}},Europe/Brussels,yyyy-MM-dd HH:mm{{/formatInTimeZone}}

312

Wat?

313

<ul>

314

<ul>{{#points}} Object: {{site}} - {{name}} met als waarde: {{value}} en maximale waarde: {{maxValue}}</ul>

</ul>

<ul>{{/points}}</ul>

Zolang het alarm actief is, wordt een herinnering verstuurd om de 2.0 uur. Om dit interval aan te passen, of de overwaking uit te zetten, dient u naar de alarminstellingen te navigeren.

Kind regards

**Site X - Low Treshold Alarm**

Hallo,

Er is een nieuw alarm opgetreden!

327

328

Wanneer?

329

Storing opgetreden op: {{#formatInTimeZone}}{{date}},Europe/Brussels,yyyy-MM-dd HH:mm{{/formatInTimeZone}}

330

Wat?

331

<ul>

332

<ul>{{#points}} Object: {{site}} - {{name}} met als waarde: {{value}} zit onder de minimale waarde: {{minValue}}</ul>

</ul>

<ul>{{/points}}</ul>

Zolang het alarm actief is, wordt een herinnering verstuurd om de 2.0 uur. Om dit interval aan te passen, of de overwaking uit te zetten, dient u naar de alarminstellingen te navigeren.

Kind regards

**Site X - Herstel Low Treshold Alarm**

Hallo,

Er is een alarm hersteld!

345

346

Wanneer?

347

Herstel opgetreden op: {{#formatInTimeZone}}{{date}},Europe/Brussels,yyyy-MM-dd HH:mm{{/formatInTimeZone}}

348

Wat?

349

<ul>

350

<ul>{{#points}} Object: {{site}} - {{name}} met als waarde: {{value}} en minimale waarde: {{minValue}}</ul>

</ul>

<ul>{{/points}}</ul>

Zolang het alarm actief is, wordt een herinnering verstuurd om de 2.0 uur. Om dit interval aan te passen, of de overwaking uit te zetten, dient u naar de alarminstellingen te navigeren.

Kind regards

**Site X - Meetpunt offline**

Hallo,

Er is een nieuw alarm opgetreden!

363

364

Wanneer?

365

Storing opgetreden op: {{#formatInTimeZone}}{{date}},Europe/Brussels,yyyy-MM-dd HH:mm{{/formatInTimeZone}}

366

Wat?

367

<ul>

368

<ul>{{#points}} Object: {{site}} - {{name}} geen data voor meetpunt binnen interval. Laatste datapunt: {{lastDatapoint}}</ul>

</ul>

<ul>{{/points}}</ul>

Zolang het alarm actief is, wordt een herinnering verstuurd om de 2.0 uur. Om dit interval aan te passen, of de overwaking uit te zetten, dient u naar de alarminstellingen te navigeren.

Kind regards

**Site X - Herstel van connectie**

Hallo,

Er is een connectie hersteld!

381

382

Wanneer?

383

Herstel opgetreden op: {{#formatInTimeZone}}{{date}},Europe/Brussels,yyyy-MM-dd HH:mm{{/formatInTimeZone}}

384

Wat?

385

<ul>

386

<ul>{{#points}} Object: {{site}} - {{name}}. Laatste datapunt: {{lastDatapoint}}</ul>

</ul>

<ul>{{/points}}</ul>

Zolang het alarm actief is, wordt een herinnering verstuurd om de 2.0 uur. Om dit interval aan te passen, of de overwaking uit te zetten, dient u naar de alarminstellingen te navigeren.

Kind regards

== **Delete an assessment** ==

(((

Click on “viewer management” and click “delete”. This will delete the evaluation

)))

[[image:1694470248546-703.png]]

== **Edit & view rights** ==

408

409

(((

410

Under the item "viewer management" you can arrange the rights of admins, installers or users.

)))

(((

)))

1) Add the user type (e.g. demo building 1 - Admin)

418

419

420

2) Give the correct rights to the user: e.g. edit rights and viewer rights

421

422

423

[[image:alarm management.gif]]

424

425

426

== **View alarm evaluations** ==

427

428

(((

429

Click on “Alarms” in the left menu and go to “Evaluations per type of alarm per building”, then click on the evaluation and click on “VIEW”.

)))

[[image:1694470271793-869.png]]

(((

A table is then shown with the measuring points and the evaluations "last data point" or "min value", "max value", and "alarm window". “value” indicates whether the configuration is evaluated negatively or positively at the time of viewing (so this is not the result of the evaluation of the service to which emails are linked).

439

)))

440

441

“email receivers” is not relevant.

442

443

444

[[image:1694470284033-611.png]]

Wiki source code of Alarm management

Applications

Navigation