Introduction
Overview
eKuiper Manager is the first fully open-source web interface and management platform designed specifically for LF Edge eKuiper, the lightweight IoT data analytics and stream processing engine.
While eKuiper provides a powerful engine for processing data at the edge, management has historically relied on proprietary or closed-source tools. eKuiper Manager fills this gap by providing a community-driven, extensible, and reliable dashboard to manage streams, rules, and plugins with ease.
Why eKuiper Manager?
This project was born out of a need for a transparent and reliable management tool for the eKuiper ecosystem. Key advantages include:
- 100% Open Source: Built with Next.js and TypeScript, allowing the community to inspect, modify, and extend the platform.
- Built for Reliability: Designed to replace buggy proprietary alternatives with a focus on stable rule management and real-time monitoring.
- AI-Native Operations: Integrates advanced AI assistants to help technicians generate rules, analyze stream logic, and troubleshoot system bottlenecks.
Core Capabilities
1. Visual Stream & Rule Management
Easily create, monitor, and manage the lifecycle of your eKuiper resources.
- Rule Topology: View a visual graph of your data flow, from sources through operators to sinks.
- Query Plan Visualization: Understand how eKuiper executes your SQL queries with detailed execution plans and performance hints.
- Stream Management: Define data sources (MQTT, HTTP, SQL, etc.) and inspect schemas through a user-friendly interface.
2. Advanced Debugging & Tracing
Debug edge processing logic in real-time without digging through system logs.
- Rule Tracing: Capture live data flows with span hierarchies to see exactly how messages are transformed at each step.
- Interactive Swagger UI: Access a complete API playground with over 70 endpoints to interact directly with your eKuiper instances.
3. AI-Powered Assistant
Leveraging OpenRouter, the manager includes a "Master AI" capable of:
- Rule & Stream Generation: Describe your requirements in plain English (e.g., "Filter temperature above 50 degrees from MQTT and send to SQL") to generate valid SQL and configurations.
- Automated Analysis: Get plain-English explanations of complex execution plans or rule logic.
- Smart Troubleshooting: The AI can analyze live trace data and metrics to identify why rules are failing or where bottlenecks exist.
Feature Status
| Feature | Status | Highlights | | :--- | :--- | :--- | | API Playground | ✅ Complete | Full OpenAPI 3.0 spec with "Try It Out" functionality. | | Rule Tracing | ✅ Complete | Real-time data flow tracing and message attribute inspection. | | AI Assistant | ✅ Complete | Conversational rule generation and log analysis. | | Rule Topology | ✅ Complete | Visual graph representation of data pipelines. | | Dashboard | 🔶 In Progress | System info, CPU/Memory monitoring, and health checks. |
Getting Started
To begin managing your edge nodes, you can connect the manager to any running eKuiper instance. The manager supports both browser-based local storage for configurations and server-side SQLite persistence for more permanent setups.
For developers looking to interact with the manager programmatically, the platform exposes a comprehensive API suite under /api/ai/ for AI-enhanced operations and /api/connections/ for managing multiple eKuiper instances.