Overview

Using Cumulocity real-time event processing, you can add your own logic to your IoT solution for immediate processing of incoming data from devices or other data sources. These user-defined operations can for example alert applications of new incoming data, create new operations based on the received data (such as sending an alarm when a threshold for a sensor is exceeded), or trigger operations on devices.

The operation logic is based on a high-level real-time processing language, the Apama Event Processing Language (EPL).

Typical real-time analytics use cases include:

  • Remote control: Turn a device off if its temperature rises over 40 degrees.
  • Validation: Discard negative meter readings or meter readings that are lower than the previous.
  • Derived data: Calculate the volume of sales transactions per vending machine per day.
  • Aggregation: Sum up the sales of vending machines for a customer per day.
  • Notifications: Send me an email if there's a power outage in one of my machines.
  • Compression: Store location updates of all cars only once every five minutes (but still send real-time data for the car that I am looking at to the user interface).

In the following sections, we describe the basics for understanding how the Apama Event Processing Language (EPL) works and how you can create your own analytics or other server-side business logic and automation.

Info: This documentation assumes basic familiarity with Apama application development. Refer to the Apama documentation for further details.

For more information about the interfaces for real-time processing also see Real-time Statements in the Reference guide.

CEP applications

The CEP installation is based on a per-tenant isolation scope, i.e. each subscribed tenant has an own instance of CEP container with dedicated resources (i.e. memory and CPU usage). The container is isolated from other tenants, hence high CPU load or memory issues on other containers do not have any impact on the own one.

You can either use predefined rules or define your own custom rules which requires the following applications:

CEP rules required applications
Pre-defined rules "smartrule" (included in Cumulocity Standard Edition) and "apama-small", "apama-medium" or "apama-large" (optional)
Custom rules "apama-small", "apama-medium" or "apama-large"