Skip to content

Administrator Guide ​

This guide describes operational administration, monitoring, maintenance, and visual management for rekuiper.

Operations Sections ​

  • Configuration: Details global configuration parameters, environment variable syntax, and configuration file precedence.
  • Version Migration: Details database schema and configuration migration procedures across releases.
  • Monitoring with Prometheus: Guides setup and visualization of runtime metrics using Prometheus and Grafana.
  • Error Codes: References system error codes and troubleshooting actions.
  • Data Tracing: Guides OpenTelemetry tracing configuration and span inspection.
  • Reliability & Stable Scope: References MQTT delivery guarantees, broker outage caching, engine recovery, backup, and rollback procedures.
  • Declarative GitOps Mode: Details manifest validation (rekuiper validate), read-only --declarative execution, and live file watching (--watch).
  • Memory Allocator: Describes the jemalloc allocator on Unix and the lock-free path for single-record ingestion requests.
  • Fleet Management & Control Plane: Details outbound WebSocket/Yamux gateway multiplexing, immutable configuration snapshots, and health-gated Canary rollouts.
  • Inspection Tools (GET /ui & rekuiper top): Details the embedded air-gapped Web Console and terminal live monitor.
rekuiper Operations, Observability & Control Plane Pillars1. Configuration & GitOpsetc/rekuiper.yaml & Env Overrides--declarative Read-Only GuardVault & Env Dynamic Secrets2-Minute eKuiper Cutover2. Live Observability32 Prometheus Metric FamiliesOpenTelemetry Span TracingEmbedded Web Console (GET /ui)Interactive CLI (rekuiper top)3. Fleet & ReliabilityYamux WebSocket Control PlaneStaged Canary Rollouts & Rollback5-Stage Dead-Letter Queues (DLQ)Persistent Sink Outage Cache

rekuiper is open source (Apache-2.0 / MIT) · For an all-in-one MQTT broker with embedded rekuiper rules, see IndraMQTT.