akenza.io
WebsiteAPI DocumentationWhat's newLogin
  • Overview
  • Getting Started
    • Connect a Device
  • Changelog
  • General
    • Applications
    • Organization context
    • Workspace Context
    • Users
      • User Roles
  • Device Management
    • Managing an organization
      • API keys
      • Users (Organization)
        • Add & removing users from your organization
    • Managing a workspace
      • General Settings
        • Device Lifecycle Reports
        • Workspace properties
        • Occupancy settings
        • Device Setup Assistant
      • Custom fields
      • Tags
      • Users (Workspace)
    • Devices
      • Device
      • Device Simulator
      • Bulk actions
      • Bulk import CSV templates
    • Rules
      • Input
      • Logic blocks
        • Comparison
        • Custom Logic
          • Logic Block Scripting
      • Timed Rules
      • Rule Actions
        • Downlink
    • Data Flows
      • Device Connectors
        • Device Security
          • Using Device Credentials
            • Creating Public/Private Key Pairs
            • Using JSON Web Tokens (JWTs)
              • Python
              • Java
        • HTTP
        • MQTT
        • CoAP
        • LoRaWAN
          • Connectivity Management
          • Swisscom LoRaWAN
          • The Things Network
          • Loriot
          • Actility’s ThingPark Wireless
          • EWZ
          • Cibicom
          • Helium
          • ChirpStack
        • NB-IoT
        • mioty
        • Disruptive Technologies
        • VergeSense
        • Spaceti
        • Haltian
      • Device Types
        • Custom Device Types
          • Uplink
          • Downlink
          • Scripting
        • Library
      • Output Connectors
        • Databases
          • akenza DB
          • InfluxDB
          • SQL Databases
        • Streaming
          • Webhook
          • Azure IoT Hub
          • AWS Kinesis
          • Google Cloud Pub/Sub
          • Apache Kafka
        • Notifications
          • E-Mail
          • SMS
          • Microsoft Teams
          • Slack
    • Custom Components
    • Integrations
    • Reference
      • REST API
        • Filtering
        • Querying Device Data
      • WebSocket API
      • Scripting
        • Stateful Operations
        • Utility Functions
      • Payload Templating
  • Reference
  • Dashboard Builder
    • Managing Dashboards
      • Embedding dashboards
    • Components
      • Map
      • Floorplan
  • Device Setup Assistant
    • Device Setup Assistant - Overview
  • Tutorials
    • BI Tools
      • Grafana Data Source Plugin
      • How to build a dashboard with Retool
      • How to analyze data with AWS QuickSight
    • Devices
      • How to integrate the XDK device from Legic via MQTT on akenza
      • How to connect the Disruptive Technologies-cloud on akenza
      • How to send Downlinks to the Kuando Busylight device
      • How to integrate an Arduino device via MQTT on akenza
      • Integrate a MClimate Vicki LoRaWAN Radiator Thermostat on akenza
      • How to integrate an ERS Elsys device with Loriot on akenza
      • How to integrate the IAM Decentlab device with TTN on akenza
      • How to integrate the Seeed SenseCAP T1000 tracker on akenza
      • How to integrate a Swisscom Multisense device on akenza
    • Notifications
      • How to send SMS notifications
      • How to send notifications to Slack
      • How to send notifications to Microsoft Teams
    • Enterprise solutions
      • How to send data to Azure IoT Hub
      • How to send data to the Google Cloud Pub/Sub
      • How to send data to InfluxDB
      • How to send data to AWS Kinesis
      • How to send data to Azure Event Hubs with Apache Kafka
    • IoT Starter Kits
      • How to integrate the IAQ Kit with Actility on akenza
      • How to integrate the CoWork Kit with Actility on akenza
      • How to integrate the Smart Building Kit with Actility on akenza
      • How to integrate the Pepperl+Fuchs Kit with Actility on akenza
  • Support Center
    • FAQ
    • Status Page
    • Service Desk
    • Request a feature
  • Deprecated
    • SIM-Cards
    • Everynet
    • Sigfox
    • How to connect the Yanzi Lifecycle cloud on akenza
Powered by GitBook
On this page
  • Common use cases
  • Main features

Was this helpful?

  1. Device Management

Rules

This page describes the basic principle and functionality of rules

PreviousBulk import CSV templatesNextInput

Last updated 5 months ago

Was this helpful?

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, SMS, Microsoft Teams, Slack)

  • Trigger or configure devices via Downlink based on a rule condition

  • Trigger REST API calls to external systems based on some condition using 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 certain business logic

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

  • Rule timer: Run rule every x hour or x minute

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 devices that have sent a data sample to akenza which in turn triggers the logic block.

Additionally, a can be selected as rule input, which will trigger the Rule Logic for all devices which have the respective tag assigned.

The Comparison 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. A allows defining a script in Javascript that is evaluated upon the rule trigger. Custom Logic Blocks are managed on the organization level.

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

Rules which are deactivated will not be triggered upon new data.

tag
Custom Logic Block
Rule setup