# apache/eventmesh architecture

> Architecture diagram of the GitHub repository apache/eventmesh, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/apache/eventmesh
- Repository: https://github.com/apache/eventmesh

## Overview

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: [`eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java`](https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java) (Runtime Ingress), [`eventmesh-storage-plugin/eventmesh-storage-api/src/main/java/org/apache/eventmesh/api/storage/MeshStoragePlugin.java`](https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-api/src/main/java/org/apache/eventmesh/api/storage/MeshStoragePlugin.java) (Storage SPI), [`eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/delivery/ReliableDispatcher.java`](https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/delivery/ReliableDispatcher.java) (Reliable Dispatcher), [`eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/StreamingAgent.java`](https://github.com/apache/eventmesh/blob/develop/eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/StreamingAgent.java) (Streaming Agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Event Runtime"]
  node_cloud["CloudEvents<br/>[CloudEvent.java]"]
  node_frame["Event Frame"]
  node_ingress["Runtime Ingress"]
  node_sdk["HTTP SDK"]
end

subgraph group_delivery["Delivery Control"]
  node_subscriptions["Subscription Manager"]
  node_dispatcher["Reliable Dispatcher"]
  node_push["Push Service<br/>[PushService.java]"]
  node_offsets[("Offset Store<br/>[OffsetStore.java]")]
  node_metrics["Runtime Metrics<br/>[UniMetrics.java]"]
end

subgraph group_storage["Storage Backends"]
  node_storage_spi["Storage SPI"]
  node_kafka[("Kafka Backend")]
  node_rocket4[("RocketMQ Backend")]
  node_rocket5[("RocketMQ 5 Backend")]
  node_memory[("Memory Backend")]
end

subgraph group_integration["Integration Ecosystem"]
  node_connectors["Connector Runtime"]
  node_a2a["A2A Gateway"]
  node_schema["Schema Catalog"]
  node_workflow["Workflow Engine"]
  node_filter["Event Filtering"]
end

subgraph group_agent["Agent Runtime"]
  node_agent["Streaming Agent"]
  node_llm["LLM Client"]
  node_tool_registry["Tool Registry<br/>[ToolRegistry.java]"]
  node_http_tool["HTTP Fetch Tool<br/>[HttpFetchTool.java]"]
end

node_publishers(("Applications"))
node_subscribers(("Subscribers"))
node_mq[("Message Queue")]

node_publishers -->|"publish events"| node_sdk
node_sdk -->|"HTTP publish"| node_ingress
node_ingress -->|"accepts events"| node_cloud
node_ingress -.->|"encodes events"| node_frame
node_ingress -->|"persists events"| node_storage_spi
node_storage_spi -->|"implements SPI"| node_kafka
node_storage_spi -->|"implements SPI"| node_rocket4
node_storage_spi -->|"implements SPI"| node_rocket5
node_storage_spi -.->|"implements SPI"| node_memory
node_storage_spi -->|"stores WAL"| node_mq
node_ingress -->|"registers subscriptions"| node_subscriptions
node_subscriptions -->|"dispatches events"| node_dispatcher
node_dispatcher -->|"pulls events"| node_storage_spi
node_dispatcher -->|"tracks offsets"| node_offsets
node_dispatcher -.->|"delivers events"| node_push
node_push -->|"pushes events"| node_subscribers
node_ingress -->|"records inflow"| node_metrics
node_ingress -->|"uses filter"| node_filter
node_connectors -.->|"publishes events"| node_ingress
node_a2a -.->|"bridges pub-sub"| node_ingress
node_schema -.->|"manages schemas"| node_ingress
node_workflow -.->|"orchestrates events"| node_ingress
node_agent -.->|"streams completions"| node_llm
node_agent -.->|"invokes tools"| node_tool_registry
node_tool_registry -.->|"registers plugin"| node_http_tool
node_agent -.->|"uses connector tools"| node_connectors

click node_cloud "https://github.com/apache/eventmesh/blob/develop/eventmesh-common/src/main/java/org/apache/eventmesh/common/protocol/grpc/cloudevents/CloudEvent.java"
click node_frame "https://github.com/apache/eventmesh/blob/develop/eventmesh-common/src/main/java/org/apache/eventmesh/common/wire/EventMeshFrame.java"
click node_ingress "https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java"
click node_sdk "https://github.com/apache/eventmesh/blob/develop/eventmesh-sdks/eventmesh-sdk-java/src/main/java/org/apache/eventmesh/client/cloudevents/CloudEventsClient.java"
click node_subscriptions "https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/subscription/SubscriptionManager.java"
click node_dispatcher "https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/delivery/ReliableDispatcher.java"
click node_push "https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/push/PushService.java"
click node_offsets "https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/offset/OffsetStore.java"
click node_metrics "https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/metrics/UniMetrics.java"
click node_storage_spi "https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-api/src/main/java/org/apache/eventmesh/api/storage/MeshStoragePlugin.java"
click node_kafka "https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-kafka/src/main/java/org/apache/eventmesh/storage/kafka/storage/KafkaMeshStoragePlugin.java"
click node_rocket4 "https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-rocketmq/src/main/java/org/apache/eventmesh/storage/rocketmq/storage/RocketMQRemotingStoragePlugin.java"
click node_rocket5 "https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-rocketmq5/src/main/java/org/apache/eventmesh/storage/rocketmq5/storage/RocketMQ5RemotingStoragePlugin.java"
click node_memory "https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-memory/src/main/java/org/apache/eventmesh/storage/memory/MemoryMeshStoragePlugin.java"
click node_connectors "https://github.com/apache/eventmesh/blob/develop/eventmesh-connector-runtime/src/main/java/org/apache/eventmesh/connector/ConnectorManager.java"
click node_a2a "https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/a2a/A2AGatewayService.java"
click node_schema "https://github.com/apache/eventmesh/tree/develop/eventmesh-runtime"
click node_workflow "https://github.com/apache/eventmesh/tree/develop/eventmesh-runtime"
click node_filter "https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java"
click node_agent "https://github.com/apache/eventmesh/blob/develop/eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/StreamingAgent.java"
click node_llm "https://github.com/apache/eventmesh/blob/develop/eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/llm/OpenAiLlmClient.java"
click node_tool_registry "https://github.com/apache/eventmesh/blob/develop/eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/tool/ToolRegistry.java"
click node_http_tool "https://github.com/apache/eventmesh/blob/develop/eventmesh-agent-plugin/eventmesh-agent-plugin-http-fetch/src/main/java/org/apache/eventmesh/agent/plugin/httpfetch/HttpFetchTool.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cloud,node_frame,node_ingress,node_sdk toneBlue
class node_subscriptions,node_dispatcher,node_push,node_offsets,node_metrics,node_mq toneAmber
class node_storage_spi,node_kafka,node_rocket4,node_rocket5,node_memory toneMint
class node_connectors,node_a2a,node_schema,node_workflow,node_filter toneRose
class node_agent,node_llm,node_tool_registry,node_http_tool,node_publishers,node_subscribers toneIndigo
```

## Components

### Event Runtime

- [CloudEvents](https://github.com/apache/eventmesh/blob/develop/eventmesh-common/src/main/java/org/apache/eventmesh/common/protocol/grpc/cloudevents/CloudEvent.java): `eventmesh-common/src/main/java/org/apache/eventmesh/common/protocol/grpc/cloudevents/CloudEvent.java`
- [Event Frame](https://github.com/apache/eventmesh/blob/develop/eventmesh-common/src/main/java/org/apache/eventmesh/common/wire/EventMeshFrame.java): `eventmesh-common/src/main/java/org/apache/eventmesh/common/wire/EventMeshFrame.java`
- [Runtime Ingress](https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java): `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java`
- [HTTP SDK](https://github.com/apache/eventmesh/blob/develop/eventmesh-sdks/eventmesh-sdk-java/src/main/java/org/apache/eventmesh/client/cloudevents/CloudEventsClient.java): `eventmesh-sdks/eventmesh-sdk-java/src/main/java/org/apache/eventmesh/client/cloudevents/CloudEventsClient.java`

### Delivery Control

- [Subscription Manager](https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/subscription/SubscriptionManager.java): `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/subscription/SubscriptionManager.java`
- [Reliable Dispatcher](https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/delivery/ReliableDispatcher.java): `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/delivery/ReliableDispatcher.java`
- [Push Service](https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/push/PushService.java): `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/push/PushService.java`
- [Offset Store](https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/offset/OffsetStore.java): `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/offset/OffsetStore.java`
- [Runtime Metrics](https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/metrics/UniMetrics.java): `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/metrics/UniMetrics.java`

### Storage Backends

- [Storage SPI](https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-api/src/main/java/org/apache/eventmesh/api/storage/MeshStoragePlugin.java): `eventmesh-storage-plugin/eventmesh-storage-api/src/main/java/org/apache/eventmesh/api/storage/MeshStoragePlugin.java`
- [Kafka Backend](https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-kafka/src/main/java/org/apache/eventmesh/storage/kafka/storage/KafkaMeshStoragePlugin.java): `eventmesh-storage-plugin/eventmesh-storage-kafka/src/main/java/org/apache/eventmesh/storage/kafka/storage/KafkaMeshStoragePlugin.java`
- [RocketMQ Backend](https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-rocketmq/src/main/java/org/apache/eventmesh/storage/rocketmq/storage/RocketMQRemotingStoragePlugin.java): `eventmesh-storage-plugin/eventmesh-storage-rocketmq/src/main/java/org/apache/eventmesh/storage/rocketmq/storage/RocketMQRemotingStoragePlugin.java`
- [RocketMQ 5 Backend](https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-rocketmq5/src/main/java/org/apache/eventmesh/storage/rocketmq5/storage/RocketMQ5RemotingStoragePlugin.java): `eventmesh-storage-plugin/eventmesh-storage-rocketmq5/src/main/java/org/apache/eventmesh/storage/rocketmq5/storage/RocketMQ5RemotingStoragePlugin.java`
- [Memory Backend](https://github.com/apache/eventmesh/blob/develop/eventmesh-storage-plugin/eventmesh-storage-memory/src/main/java/org/apache/eventmesh/storage/memory/MemoryMeshStoragePlugin.java): `eventmesh-storage-plugin/eventmesh-storage-memory/src/main/java/org/apache/eventmesh/storage/memory/MemoryMeshStoragePlugin.java`

### Integration Ecosystem

- [Connector Runtime](https://github.com/apache/eventmesh/blob/develop/eventmesh-connector-runtime/src/main/java/org/apache/eventmesh/connector/ConnectorManager.java): `eventmesh-connector-runtime/src/main/java/org/apache/eventmesh/connector/ConnectorManager.java`
- [A2A Gateway](https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/a2a/A2AGatewayService.java): `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/a2a/A2AGatewayService.java`
- [Schema Catalog](https://github.com/apache/eventmesh/tree/develop/eventmesh-runtime): `eventmesh-runtime`
- [Workflow Engine](https://github.com/apache/eventmesh/tree/develop/eventmesh-runtime): `eventmesh-runtime`
- [Event Filtering](https://github.com/apache/eventmesh/blob/develop/eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java): `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java`

### Agent Runtime

- [Streaming Agent](https://github.com/apache/eventmesh/blob/develop/eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/StreamingAgent.java): `eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/StreamingAgent.java`
- [LLM Client](https://github.com/apache/eventmesh/blob/develop/eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/llm/OpenAiLlmClient.java): `eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/llm/OpenAiLlmClient.java`
- [Tool Registry](https://github.com/apache/eventmesh/blob/develop/eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/tool/ToolRegistry.java): `eventmesh-agent-runtime/src/main/java/org/apache/eventmesh/agent/tool/ToolRegistry.java`
- [HTTP Fetch Tool](https://github.com/apache/eventmesh/blob/develop/eventmesh-agent-plugin/eventmesh-agent-plugin-http-fetch/src/main/java/org/apache/eventmesh/agent/plugin/httpfetch/HttpFetchTool.java): `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

- Applications → HTTP SDK: publish events
- HTTP SDK → Runtime Ingress: HTTP publish
- Runtime Ingress → CloudEvents: accepts events (evidence: `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java`)
- Runtime Ingress → Event Frame: encodes events (evidence: `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java`)
- Runtime Ingress → Storage SPI: persists events (evidence: `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java`)
- Storage SPI → Kafka Backend: implements SPI (evidence: `eventmesh-storage-plugin/eventmesh-storage-kafka/src/main/java/org/apache/eventmesh/storage/kafka/storage/KafkaMeshStoragePlugin.java`)
- Storage SPI → RocketMQ Backend: implements SPI (evidence: `eventmesh-storage-plugin/eventmesh-storage-rocketmq/src/main/java/org/apache/eventmesh/storage/rocketmq/storage/RocketMQRemotingStoragePlugin.java`)
- Storage SPI → RocketMQ 5 Backend: implements SPI (evidence: `eventmesh-storage-plugin/eventmesh-storage-rocketmq5/src/main/java/org/apache/eventmesh/storage/rocketmq5/storage/RocketMQ5RemotingStoragePlugin.java`)
- Storage SPI → Memory Backend: implements SPI (evidence: `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 (evidence: `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 (evidence: `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 (evidence: `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/ingress/UniIngressService.java`)
- Runtime Ingress → Event Filtering: uses filter (evidence: `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 (evidence: `eventmesh-runtime/src/main/java/org/apache/eventmesh/runtime/admin/UniAdminService.java`)
- Workflow Engine → Runtime Ingress: orchestrates events (evidence: `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
