Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/project-flogo/stream

Elegant stream processing pipeline written entirely in Golang
https://github.com/project-flogo/stream

edge flogo stream-processing streaming

Last synced: about 1 month ago
JSON representation

Elegant stream processing pipeline written entirely in Golang

Awesome Lists containing this project

README

        




Streams is a pipeline based, stream processing action for the Project Flogo Ecosystem






# Flogo Stream

Edge devices have the potential for producing millions or even billions of events at rapid intervals, often times the events on their own are meaningless, hence the need to provide basic streaming operations against the slew of events.

A native streaming action as part of the Project Flogo Ecosystem accomplishes the following primary objectives:

- Enables apps to implement basic streaming constructs in a simple pipeline fashion
- Provides non-persistent state for streaming operations
- Streams are persisted in memory until the end of the pipeline
- Serves as a pre-process pipeline for raw data to perform basic mathematical and logical operations. Ideal for feeding ML models

Some of the key highlights include:

πŸ˜€ **Simple pipeline** construct enables a clean, easy way of dealing with streams of data

⏳ **Stream aggregation** across streams using time or event tumbling & sliding windows

πŸ™Œ **Join streams** from multiple event sources

πŸŒͺ **Filter** out the noise with stream filtering capabilities

## Getting Started

We’ve made building powerful streaming pipelines as easy as possible. Develop your pipelines using:

- A simple, clean JSON-based DSL
- Golang API

See the sample below of an aggregation pipeline (for brevity, the triggers and metadata of the resource has been omitted). Also don’t forget to check out the [examples](https://github.com/project-flogo/stream/tree/master/examples) in the repo.

```json
"stages": [
{
"ref": "github.com/project-flogo/stream/activity/aggregate",
"settings": {
"function": "sum",
"windowType": "timeTumbling",
"windowSize": "5000"
},
"input": {
"value": "=$.input"
}
},
{
"ref": "github.com/project-flogo/contrib/activity/log",
"input": {
"message": "=$.result"
}
}
]
```

## Try out the example

Firstly you should install the install the [Flogo CLI](https://github.com/project-flogo/cli).

Next you should download our aggregation example [agg-flogo.json](https://github.com/project-flogo/stream/blob/master/examples/agg-flogo.json).

We'll create a our application using the example file, we'll call it myApp

```bash
$ flogo create -f agg-flogo.json myApp
```

Now, build it...

```bash
$ cd myApp/
$ flogo build
```

## Activities

Flogo Stream also provides some activities to assist in stream processing.

* [Aggregate](activity/aggregate/README.md) : This activity allows you to aggregate data and calculate an average or sliding average.
* [Filter](activity/filter/README.md) : This activity allows you to filter out data in a streaming pipeline.

## License
Flogo source code in [this](https://github.com/project-flogo/stream) repository is under a BSD-style license, refer to [LICENSE](https://github.com/project-flogo/strem/blob/master/LICENSE)