Rules

This page describes the basic principle and functionality of rules

Rules allow applying business logic to incoming data in order to trigger actions or alarm notifications.

Common use cases

  • Trigger alarms based on defined conditions/thresholds and inform users via different channels (i.e. Mail)

  • Trigger REST API calls to external systems based on some condition (Webhooks)

Main features

  • real-time alerting: Trigger an alert if an important event in the physical world happens

  • data-management: Only store or forward data based on some business logic

  • device commands: send downlinks from the cloud to IoT devices based on business logic

Rules consist of three components: Input, Logic and Action. Rule inputs define which devices provide the data to be used, the rule logic defines the condition to be applied to the data and the rule actions define which action is triggered if the condition is met.

The sections can be freely linked to each other by using the dots. Clicking on them reveals the possible destination. After the assignment, a blue line will indicate which blocks are linked to each other.

The input section is used to define one or more inputs that will trigger the logic. Inputs are usually devices that have sent a data sample to akenza which in turn triggers the logic block.

The rule logic allows comparing device data to either a constant value, a past value (last sample) of the same device or a past value from another device. Based on the result of the comparison a rule action is triggered. By adding one or several data sources and conditions, a rule logic can be easily extended.

The action section is used to define the action which is taken after the condition in the logic section evaluated to true. Once the rule is saved, the actions can be re-used in other rules.

Simple Rule
More complex Rule