Event

Whenever Result changes (from true to false and vice versa), Events may be triggered. Events includes Actions such as sending of notifications, commands to systems or request to a webhook.

General Information

Name and Description

An Event has a Name and Description. The Name and Description allows you to describe the event or situation that the Expression detects, such that recipients of the Event's notification or Alarms knows exactly what happened and is able to react to it accordingly.

The Event's Name and Description is displayed in the Alarm Description on the Digital Twin.

Description can also be the default content of an Action. You can describe the event or situation once in the Description, and reuse the information in all the Actions of the Event.

Inputs

You can define Inputs tags in the Event. These Inputs tags are linked to values or tag of input data coming from the related Expression. By doing so, you can embed the Inputs in the Description. You can learn more on how to embed the Input in the Description as described here.

Example

Using our Smart Weighing Scale measurement from earlier, the general information for one simple Event can be as follows:

Name: Battery level low
Inputs: weighing_scale_id, current_battery_level
Description: Weighing scale $(weighing_scale_id) battery level is running low. Current battery level: $(current_battery_level)

Action

There are 3 types of content options available for Action, namely:

Notification
Command
Webhook

Notification

Notifications such as Email, SMS and Telegram can be sent to personnel listed upon Event execution. You will be able to describe the event or situation that has happened to the recipient of the notification in the subject and message of a notification.

To further aid you in describing the event, you can embed the Event Input in the subject and message of a notification.

Take a look at this more detailed example.

Command

Commands can be sent to external system integrated with Senfi to directly control the sensors in the external system. E.g. Command sent to lift system to automatically make a lift call for a VIP upon arrival.

Webhook

Webhook request can be sent to external systems such as work order system via Webhook address. You can pass the required parameters in the message body of a Webhook.

Detailed Example

The event that you would like to be notified about is chiller malfunction in a building. There are chiller equipment to help power the air-conditioning in a building. When the status of a chiller shows that it has failed to run, the chiller probably has malfunctioned. You would like to be notified by email of such an occurrence, automatically switch on the backup chiller and issue a work order for maintenance repair.

The Input in this example would be the metric and measurement that readings from chiller equipment is sent to. e.g: iot_chiller_v1.status
Condition is iot_chiller_v1.status = failed to run
Event: Chiller equipment malfunctioned
Event Input: device_id and chiller_status
Notification Action: Email, with body text:

"Chiller device no: ${device_id} has malfunctioned. Chiller status: ${chiller_status}. Please investigate."

Command Action: Send command to backup chiller to turn it on.
Webhook Action: Send webhook to issue work order for chiller maintenance repair.

With the above Expression configured, when iot_chiller_v1.status is equivalent to failed to run, an email will be sent with the body text:

"Chiller device no: 05 has malfunctioned. Chiller status: failed to run. Please investigate."

At the same time, the backup chiller will automatically startup and take over the malfunctioned chiller, and a work order will be issued to request for chiller maintenance repair.

Note: "device_id" come from the Device ID Tag of the iot_chiller_v1 measurement that identifies a particular chiller.

V2/Concepts/Event

Contents