How apache/eventmesh works
Apache EventMesh is event middleware: clients publish CloudEvents, the Runtime accepts and stores them, then manages subscriptions, offsets and delivery independently of broker semantics. The principal path is publish → Runtime ingress → durable storage, followed by Runtime-owned dispatch to HTTP/SSE/WebSocket subscribers with acknowledgements and redelivery. The README also describes connectors, A2A, agent tools, schema management, workflows and filtering. Several subsystems are documented but not sampled here; their links are shown only where the README supports them.
Main entry points: UniIngressService.java Runtime Ingress · MeshStoragePlugin.java Storage SPI · ReliableDispatcher.java Reliable Dispatcher · StreamingAgent.java Streaming Agent
Components 26
Event Runtime
- CloudEvents
eventmesh-common/src/main/java/org/apache/eventmesh/common/protocol/grpc/cloudevents/CloudEvent.java - Event Frame
eventmesh-common/src/main/java/org/apache/eventmesh/common/wire/EventMeshFrame.java - Runtime Ingress
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java - HTTP SDK
eventmesh-sdks/eventmesh-sdk-java/src/main/java/org/apache/eventmesh/client/cloudevents/CloudEventsClient.java
Delivery Control
- Subscription Manager
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/subscription/SubscriptionManager.java - Reliable Dispatcher
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/delivery/ReliableDispatcher.java - Push Service
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/push/PushService.java - Offset Store
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/offset/OffsetStore.java - Runtime Metrics
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/metrics/UniMetrics.java
Storage Backends
- Storage SPI
eventmesh-storage-plugin/eventmesh-storage-api/src/main/java/org/apache/eventmesh/api/storage/MeshStoragePlugin.java - Kafka Backend
eventmesh-storage-plugin/eventmesh-storage-kafka/src/main/java/org/apache/eventmesh/storage/kafka/storage/KafkaMeshStoragePlugin.java - RocketMQ Backend
eventmesh-storage-plugin/eventmesh-storage-rocketmq/src/main/java/org/apache/eventmesh/storage/rocketmq/storage/RocketMQRemotingStoragePlugin.java - RocketMQ 5 Backend
eventmesh-storage-plugin/eventmesh-storage-rocketmq5/src/main/java/org/apache/eventmesh/storage/rocketmq5/storage/RocketMQ5RemotingStoragePlugin.java - Memory Backend
eventmesh-storage-plugin/eventmesh-storage-memory/src/main/java/org/apache/eventmesh/storage/memory/MemoryMeshStoragePlugin.java
Integration Ecosystem
- Connector Runtime
eventmesh-connector-runtime/src/main/java/org/apache/eventmesh/connector/ConnectorManager.java - A2A Gateway
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/a2a/A2AGatewayService.java - Schema Catalog
eventmesh-runtime - Workflow Engine
eventmesh-runtime - Event Filtering
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java
Agent Runtime
- Streaming Agent
eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/StreamingAgent.java - LLM Client
eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/llm/OpenAiLlmClient.java - Tool Registry
eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/tool/ToolRegistry.java - HTTP Fetch Tool
eventmesh-agent-plugin/eventmesh-agent-plugin-http-fetch/src/main/java/org/apache/eventmesh/agent/plugin/httpfetch/HttpFetchTool.java
Other components
- Applications
- Subscribers
- Message Queue
Connections 26
- Applications → HTTP SDK: publish events
- HTTP SDK → Runtime Ingress: HTTP publish
- Runtime Ingress → CloudEvents: accepts events
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java - Runtime Ingress → Event Frame: encodes events
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java - Runtime Ingress → Storage SPI: persists events
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java - Storage SPI → Kafka Backend: implements SPI
eventmesh-storage-plugin/eventmesh-storage-kafka/src/main/java/org/apache/eventmesh/storage/kafka/storage/KafkaMeshStoragePlugin.java - Storage SPI → RocketMQ Backend: implements SPI
eventmesh-storage-plugin/eventmesh-storage-rocketmq/src/main/java/org/apache/eventmesh/storage/rocketmq/storage/RocketMQRemotingStoragePlugin.java - Storage SPI → RocketMQ 5 Backend: implements SPI
eventmesh-storage-plugin/eventmesh-storage-rocketmq5/src/main/java/org/apache/eventmesh/storage/rocketmq5/storage/RocketMQ5RemotingStoragePlugin.java - Storage SPI → Memory Backend: implements SPI
eventmesh-storage-plugin/eventmesh-storage-memory/src/main/java/org/apache/eventmesh/storage/memory/MemoryMeshStoragePlugin.java - Storage SPI → Message Queue: stores WAL
- Runtime Ingress → Subscription Manager: registers subscriptions
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java - Subscription Manager → Reliable Dispatcher: dispatches events
- Reliable Dispatcher → Storage SPI: pulls events
- Reliable Dispatcher → Offset Store: tracks offsets
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/delivery/ReliableDispatcher.java - Reliable Dispatcher → Push Service: delivers events
- Push Service → Subscribers: pushes events
- Runtime Ingress → Runtime Metrics: records inflow
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java - Runtime Ingress → Event Filtering: uses filter
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java - Connector Runtime → Runtime Ingress: publishes events
- A2A Gateway → Runtime Ingress: bridges pub-sub
- Schema Catalog → Runtime Ingress: manages schemas
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/admin/UniAdminService.java - Workflow Engine → Runtime Ingress: orchestrates events
eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/admin/UniAdminService.java - Streaming Agent → LLM Client: streams completions
- Streaming Agent → Tool Registry: invokes tools
- Tool Registry → HTTP Fetch Tool: registers plugin
- Streaming Agent → Connector Runtime: uses connector tools