Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/lf-edge/ekuiper

Lightweight data stream processing engine for IoT edge
https://github.com/lf-edge/ekuiper

edge edge-analytics edge-computing edge-streaming hacktoberfest iot rule-engine sql

Last synced: 5 days ago
JSON representation

Lightweight data stream processing engine for IoT edge

Host: GitHub
URL: https://github.com/lf-edge/ekuiper
Owner: lf-edge
License: apache-2.0
Created: 2019-07-03T07:37:12.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-12-31T11:40:45.000Z (12 days ago)
Last Synced: 2025-01-05T07:52:18.265Z (7 days ago)
Topics: edge, edge-analytics, edge-computing, edge-streaming, hacktoberfest, iot, rule-engine, sql
Language: Go
Homepage: https://ekuiper.org
Size: 115 MB
Stars: 1,512
Watchers: 45
Forks: 416
Open Issues: 58
Metadata Files:
- Readme: README-CN.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

awesome-go - ekuiper - Lightweight data stream processing engine for IoT edge. (IoT (Internet of Things) / Search and Analytic Databases)
awesome-ccamel - lf-edge/ekuiper - Lightweight data stream processing engine for IoT edge (Go)
awesome-go - ekuiper - Lightweight data stream processing engine for IoT edge. Stars:`1.5K`. (IoT (Internet of Things) / Search and Analytic Databases)
my-awesome - lf-edge/ekuiper - analytics,edge-computing,edge-streaming,hacktoberfest,iot,rule-engine,sql pushed_at:2024-12 star:1.5k fork:0.4k Lightweight data stream processing engine for IoT edge (Go)

README

        # LF Edge eKuiper - 超轻量物联网边缘数据分析软件

[![GitHub Release](https://img.shields.io/github/release/lf-edge/ekuiper?color=brightgreen)](https://github.com/lf-edge/ekuiper/releases)

[![Docker Pulls](https://img.shields.io/docker/pulls/lfedge/ekuiper)](https://hub.docker.com/r/lfedge/ekuiper)

[![codecov](https://codecov.io/gh/lf-edge/ekuiper/branch/master/graph/badge.svg?token=24E9Q3C0M0)](https://codecov.io/gh/lf-edge/ekuiper)

[![Go Report Card](https://goreportcard.com/badge/github.com/lf-edge/ekuiper)](https://goreportcard.com/report/github.com/lf-edge/ekuiper)

[![Slack](https://img.shields.io/badge/Slack-LF%20Edge-39AE85?logo=slack)](https://slack.lfedge.org/)

[![Twitter](https://img.shields.io/badge/Follow-EMQ-1DA1F2?logo=twitter)](https://twitter.com/EMQTech)

[![问答社区](https://img.shields.io/badge/问答社区-Kuiper-yellow)](https://askemq.com/c/kuiper/)

[![YouTube](https://img.shields.io/badge/Subscribe-EMQ%20中文-FF0000?logo=youtube)](https://www.youtube.com/channel/UCir_r04HIsLjf2qqyZ4A8Cg)

[English](README.md) | [简体中文](README-CN.md)

## 概览

LF Edge eKuiper 是一款可以运行在各类资源受限硬件上的轻量级物联网边缘分析、流式处理开源软件。eKuiper 的一个主要目标在边缘端提供一个实时流式计算框架（与 [Apache Flink](https://flink.apache.org) 类似）。eKuiper 的规则引擎允许用户使用基于 SQL 方式，或者 Graph 方式的规则，几分钟内快速创建边缘端的分析应用。

![arch](./docs/zh_CN/resources/arch.png)

**应用场景**

eKuiper 可以运行在各类物联网的边缘使用场景中，比如，

 - 工业物联网中对生产线数据进行实时处理；

 - 车联网中的车机对来自汽车总线数据的即时分析；

 - 智慧能源场景中，风电和大规模储能场景中进行实时分析；

 

 通过 eKuiper 在边缘端的处理，可以提升系统响应速度，节省网络带宽费用和存储成本，以及提高系统安全性等。

## 功能

- 超轻量

  - 核心服务安装包约 4.5MB，首次运行内存使用约 10MB

- 跨平台

  - CPU 架构：X86 AMD * 32/64; ARM * 32/64; PPC

  - 常见 Linux 发行版、OpenWrt 嵌入式系统、MacOS、Docker

  - 工控机、树莓派、工业网关、家庭网关、MEC 边缘云等

- 完整的数据分析

  - 数据抽取、转换和过滤

  - 数据排序、分组、聚合、连接

  - 60+ 各类函数，覆盖数学运算、字符串处理、聚合运算和哈希运算等

  - 4 类时间窗口，以及计数窗口

- 高可扩展性

  可支持通过 Golang 或者 Python 在 `源 (Source)`，`SQL 函数`，`目标 (Sink)` 三个方面的扩展

  - 源 (Source) ：允许用户接入更多的数据源用于数据分析

  - 目标(Sink)：允许用户将分析结果发送到不同的扩展系统中

  - SQL 函数：允许用户增加自定义函数用于数据分析（比如，AI/ML 的函数调用）

- 管理能力

  - [免费基于 Web 的管理控制台](https://hub.docker.com/r/emqx/ekuiper-manager)，用于可视化管理

  - 通过命令行、REST API 和 config map 对流、规则和插件进行管理

  - 与 [KubeEdge](https://github.com/kubeedge/kubeedge)、[OpenYurt](https://openyurt.io/)、[K3s](https://github.com/rancher/k3s)、[Baetyl](https://github.com/baetyl/baetyl) 等基于边缘 Kubernetes 框架的集成能力

- 与 EMQX 产品集成

  与 [EMQX](https://www.emqx.io/), [Neuron](https://neugates.io/) 和 [NanoMQ](https://nanomq.io/) 等产品无缝集成，为 IIoT 和 IoV 等提供端到端的解决方案

## 快速入门

- [5分钟快速入门](docs/zh_CN/getting_started/quick_start_docker.md)

- [快速开始](docs/zh_CN/getting_started/getting_started.md)

- [EdgeX 规则引擎教程](docs/zh_CN/edgex/edgex_rule_engine_tutorial.md)

## 社区

你可通过以下途径与 EMQ 社区及开发者联系:

- [Forum](https://askemq.com/c/ekuiper)

- [Weibo](https://weibo.com/emqtt)

- [Blog](https://www.emqx.com/zh/blog)

- [Slack](https://slack.lfedge.org/): 

    - [ekuiper](https://lfedge.slack.com/archives/C024F4P7KCK) 

    - [ekuiper-user](https://lfedge.slack.com/archives/C024F4SMEMR)

- [Twitter](https://twitter.com/EMQTech)

- [Reddit](https://www.reddit.com/r/emqx/)

- [Facebook](https://www.facebook.com/emqxmqtt)

欢迎你将任何 bug、问题和功能请求提交到 [lf-edge/ekuiper](https://github.com/lf-edge/ekuiper/issues)。

### 会议

欢迎订阅[社区日历](https://lists.lfedge.org/g/ekuiper-tsc/calendar?calstart=2021-08-06) 。

欢迎参加社区周会，每周五早上 10:30（北京时间）举行。

- [Zoom 会议链接](https://zoom.us/j/95097577087?pwd=azZaOXpXWmFoOXpqK293RFp0N1pydz09 )

- [会议纪要](https://wiki.lfedge.org/display/EKUIPER/Weekly+Development+Meeting)

### 贡献

感谢您的贡献！请参阅 [CONTRIBUTING.md](./docs/zh_CN/CONTRIBUTING.md) 获取详细信息。

## 性能测试结果

### MQTT 吞吐量测试支持

- 使用 JMeter MQTT 插件来发送数据到 [EMQX](https://www.emqx.io/) 服务器，消息类似于 `{"temperature": 10, "humidity" : 90}`， 温度与湿度的值是介于 0 ～ 100 之间的随机整数值

- eKuiper 从 EMQX 服务器订阅消息，并且通过 SQL 分析数据： `SELECT * FROM demo WHERE temperature > 50 `

- 分析结果通过 [文件插件](docs/zh_CN/guide/sinks/plugin/file.md) 写到本地的文件系统里

| 设备                                                   | 每秒发送消息数 | CPU 使用          | 内存  |

|------------------------------------------------------|---------|-----------------|-----|

| 树莓派 3B+                                              | 12k     | sys + user: 70% | 20M |

| AWS t2.micro (x86: 1 Core * 1 GB) 
Ubuntu 18.04 | 10k     | sys + user: 25% | 20M |

### EdgeX 吞吐量测试

- 一个 [Go 应用](test/edgex/benchmark/pub.go) 用于向 ZeroMQ 消息总线发送数据，数据如下。

  ```

  {

    "Device": "demo", "Created": 000, …

    "readings": 

    [

       {"Name": "Temperature", value: "30", "Created":123 …},

       {"Name": "Humidity", value: "20", "Created":456 …}

    ]

  }

  ```

- eKuiper 从 EdgeX ZeroMQ 消息总线订阅数据，并且使用 `SELECT * FROM demo WHERE temperature > 50 ` 来分析数据，其中 90%

  数据被规则所过滤。

- 分析结果将被发送到 [nop sink](docs/zh_CN/guide/sinks/builtin/nop.md)，所有的数据都被忽略。

|                                                | 每秒发送消息数 | CPU 使用        | 内存  |

|------------------------------------------------|---------|---------------|-----|

| AWS t2.micro( 1 Core * 1 GB) 
Ubuntu18.04 | 11.4 k  | sys+user: 75% | 32M |

### 最大规则数支持

- 8000 条规则，总吞吐量为 800 条消息/秒

- 配置

  - AWS 2 核 * 4GB 内存 

  - Ubuntu

- 资源消耗

  - 内存: 89% ~ 72%

  - CPU: 25%

  - 400KB - 500KB / 规则

- 规则

  - 源: MQTT

  - SQL: `SELECT temperature FROM source WHERE temperature > 20` (90% 数据被过滤) 

  - 目标: 日志

### 多规则共享源实例测试

- 300 条规则，处理一个共享流

  - MQTT 源吞吐量为 500 条消息/秒

  - 总的消息处理吞吐量为 150，000 条消息/秒

- 配置

  - AWS 2 核 * 2GB 内存

  - Ubuntu

- 资源消耗

  - 内存: ~95MB

  - CPU: 50%

- 规则

  - 源: MQTT

  - SQL: `SELECT temperature FROM source WHERE temperature > 20` (90% 数据被过滤)

  - 目标: 90% nop 10% MQTT

请参考[测试指南](./test/benchmark/multiple_rules/readme.md)进行该基准测试。

## 文档

请到官网查看[最新的文档](https://ekuiper.org/docs/zh/latest) 

## 视频教程

- [基于 KubeEdge 和 Kuiper的边缘流式数据处理实践](https://www.bilibili.com/video/BV1h54y167CL?from=search&seid=9124550685624172830)

- [云边协同高效实现物联网边缘流式业务处理 - 华为 IEF & EMQX Kuiper 轻量级边缘数据解决方案](https://www.bilibili.com/video/BV1hQ4y1A7Vy?from=search&seid=9124550685624172830)

- [EdgeX 规则引擎实战](https://zoom.us/rec/play/DgWxHH6_d33nTzlsQP3WgHu0jJCezPG2sXOK72GVb3RcSZvubFMIYvJiY9gwPIIRYXK7t-5XaYdCmBLi.9eDmWb-Fncv8J6_v?startTime=1627005637000)

## 从源码编译

#### 准备

+ Go version >= 1.23

#### 编译

+ 编译二进制：

  - 编译二进制文件: `$ make`

  - 编译支持 EdgeX 的二进制文件: `$ make build_with_edgex`

  - 编译核心包的二进制文件: `$ make build_core`

+ 安装文件打包：

  - 安装文件打包：: `$ make pkg`

  - 支持 EdgeX 的安装文件打包: `$ make pkg_with_edgex`

+ Docker 镜像：`$ make docker`

  > Docker 镜像默认支持 EdgeX

项目版本页面里提供了预编译的二进制文件。如果您的操作系统或架构没有预编译的文件，请使用交叉编译自行构建，请参考[此文档](docs/zh_CN/operation/compile/cross-compile.md)。

编译时，用户可通过 go build tags

选择需要编译的功能编译出自定义的仅包含所需功能的二进制包从而减少可执行文件的大小。在资源受限的环境中，包的大小尤其重要。进一步的信息，请参考[功能](docs/zh_CN/operation/compile/features.md)。

## 开源版权

[Apache 2.0](LICENSE)