The “Cumulocity Nodes” collection provides functionality to retrieve information about IoT devices, corresponding measurements, alarms and events from a given Cumulocity IoT platform instance. This data, possibly in combination with any other data, can be used to create new events and alarms within KNIME and write them back to Cumulocity in order to trigger the corresponding actions within Cumulocity.
The “Cumulocity Nodes” collection for KNIME utilizes the REST interface of Cumulocity. By the nature of REST interfaces, we recommend to limit the amount of data retrieved by preselecting the required device data to ensure error-free and fast retrieval. We have already implemented a number of filters (see below) for some of the nodes that enable users to restrict the amount of data that is retrieved. Please feel free to use the feature request option if you need addtional filters.
The following nodes are currently available in KNIME:
- Cumulocity Connector: stores connection information in KNIME and creates the corresponding 'connection port' that can be used by subsequent nodes to call the REST interface of Cumulocity in order to GET and POST information.
- Cumulocity Device Retriever: retrieves basic information (id, type, and name) about devices from Cumulocity.
- Cumulocity Measurements Retriever: retrieves measurements from Cumulocity. Supported filters are: maximal number of measurements, date range and device ids.
- Cumulocity Measurements Creator: writes measurements back to Cumulocity. This node has been implemented primarily for testing purposes. Measurements are typically created by devices and not programmatically.
- Cumulocity Events Retriever: retrieves events from Cumulocity. Supported filters are: maximal number of events and date range.
- Cumulocity Events Creator: write events back to Cumulocity.
- Cumulocity Alarms Retriever: retrieves alarms from Cumulocity. Supported filters are: maximal number of alarms and date range.
- Cumulocity Alarms Creator: writes alarms back to Cumulocity.
No specific visualization has been implemented.
You can install these nodes in KNIME 4.2 or above following these steps:
in KNIME, open Help/Install new software
Click top right button “Add”, and add the repository:
name: experimental update site
Location: http://update.knime.com/community-contributions/4.2
After clicking ok, select this new entry in the combo box,
Select the collection of nodes named “Cumulocity Nodes” (for example, by typing 'Cumulocity' in the search box).
Follow the next steps to install the Cumulocity extension nodes.
Copyright (c) 2020 tarent solutions GmbH. This program and the accompanying materials are made available under the terms of the GNU GENERAL PUBLIC LICENSE which accompanies this distribution, and is available at https://www.gnu.org/licenses/gpl-3.0.html.
The source code is shared in GitHub. Contributions are warmly welcomed. Please report bugs, or feature requests, in the GitHub bugtracker.