Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SoftwareAG/apama-analytics-builder-block-sdk
Apama Analytics Builder Block SDK
https://github.com/SoftwareAG/apama-analytics-builder-block-sdk
apama apama-analytics-builder apama-in-cumulocity iot-analytics sdk
Last synced: 3 months ago
JSON representation
Apama Analytics Builder Block SDK
- Host: GitHub
- URL: https://github.com/SoftwareAG/apama-analytics-builder-block-sdk
- Owner: SoftwareAG
- License: apache-2.0
- Created: 2019-05-31T16:33:57.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-07-22T13:07:46.000Z (4 months ago)
- Last Synced: 2024-07-22T15:36:26.984Z (4 months ago)
- Topics: apama, apama-analytics-builder, apama-in-cumulocity, iot-analytics, sdk
- Language: Python
- Homepage:
- Size: 5.29 MB
- Stars: 9
- Watchers: 9
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-softwareag - apama-analytics-builder-block-sdk - A Software Development Kit (SDK) for producing blocks for the Apama Analytics Builder Block SDK. (IoT & Analytics /  Apama)
README
# apama-analytics-builder-block-sdk
This is a Software Development Kit (SDK) for producing blocks for the Apama Analytics Builder Block SDK.
## Disclaimer
These tools are provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the main project.
## Licensing
This project is licensed under the Apache 2.0 license - see
This excludes the Analytics Framework 'CDP' file, which is provided in binary form only for the purpose of testing.
## Analytics Builder version
Use the 'main' branch for the current release or switch to the appropriate branch for Long-term support (LTS) / Maintenance releases.
## System requirements
This script requires an installation of Python 3.7+ and runs on either Windows or Linux. To build extensions or configure Software AG Designer, a full installation of the latest Apama is required. If you do not already have access, then you can download the Apama Community Edition from [Apama Downloads](https://apamacommunity.com/downloads) (shortly after the official Software AG release date). If you choose to install Apama, you can skip the manual installation of Python, as it is shipped with Apama.
The [apama-builder](https://hub.docker.com/r/softwareag/apama-builder) Docker image from Docker Hub can also be used for building and managing extensions.
Note that Analytics Builder requires your Cumulocity IoT tenant to be subscribed to an 'apama-ctrl' microservice. The 'apama-ctrl-starter' microservice offers only restricted functionality and does not support custom blocks.
## Documentation
The guide to writing blocks is available in the [doc directory](doc/000-contents.md) and there is [ApamaDoc reference](https://softwareag.github.io/apama-analytics-builder-block-sdk/doc/apamadoc/index.html) available.
## Getting started
From an Apama command prompt:
* Run sample tests (Windows):
```bat
set ANALYTICS_BUILDER_SDK=%cd%
cd samples/tests
pysys run
```
* Run sample tests (Unix):
```bash
export ANALYTICS_BUILDER_SDK=`pwd`
cd samples/tests
pysys run
```
* Package samples as an extension and upload:
```bash
analytics_builder build extension --input samples/blocks --cumulocity_url --username / --password --name sample-blocks --restart
```
> **Note:** After running the above command, the apama-ctrl microservice will be restarted.
## Change Log
See [Change Log](CHANGELOG.md) for changes.
## Migration of input and output blocks to the version 2 API
See [Migrating input and output blocks to the version 2 API](doc/150-MigrateInputOutputBlocks.md) for details on migrating custom input and output blocks to the version 2 API.