# provectus/kafka-ui architecture

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

- Interactive diagram: https://gitdiagram.com/provectus/kafka-ui
- Repository: https://github.com/provectus/kafka-ui

## Overview

UI for Apache Kafka is a web application for monitoring and managing Kafka clusters. The user-facing workflow is to inspect cluster resources and perform operational actions; major capabilities also include message browsing/production, schema management, Connect, ksqlDB, metrics, authentication/RBAC, and masking. The tree and excerpts support the backend topic/admin-client and RBAC relationships shown here. Other documented capabilities are represented as subsystems, but their internal call paths are not inferred from filenames alone.

Main entry points: [`kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/TopicsService.java`](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/TopicsService.java) (Topics), [`kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/analyze/TopicAnalysisService.java`](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/analyze/TopicAnalysisService.java) (Topic analysis), [`kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/AdminClientService.java`](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/AdminClientService.java) (Admin client service), [`kafka-ui-react-app/src/components/App.tsx`](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-react-app/src/components/App.tsx) (Web application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_web["Web application<br/>[App.tsx]"]
  node_api["HTTP API"]
end

subgraph group_cluster["Cluster operations"]
  node_cluster_config["Cluster configuration"]
  node_cluster_model["Cluster context<br/>[KafkaCluster.java]"]
  node_topics["Topics<br/>[TopicsService.java]"]
  node_topic_model["Topic representation<br/>[InternalTopic.java]"]
  node_admin_service["Admin client service"]
  node_admin_client["Reactive Kafka admin"]
  node_consumer_groups["Consumer groups"]
end

subgraph group_integrations["Kafka integrations"]
  node_message_tools["Message browsing and serdes"]
  node_schema_registry["Schema registry"]
  node_connect["Kafka Connect"]
  node_ksql["ksqlDB"]
end

subgraph group_security["Security and governance"]
  node_acls["ACL management<br/>[AclsService.java]"]
  node_authentication["Authentication"]
  node_rbac["Role-based access"]
  node_masking["Data masking<br/>[DataMasking.java]"]
  node_audit["Audit logging<br/>[AuditService.java]"]
end

subgraph group_analysis["Observability and analysis"]
  node_brokers_metrics["Broker metrics"]
  node_topic_analysis["Topic analysis"]
end

node_user(("Kafka UI user"))
node_kafka[("Apache Kafka cluster")]

node_user -->|"uses"| node_web
node_web -.->|"requests"| node_api
node_topics -->|"requests clients"| node_admin_service
node_topics -->|"builds"| node_topic_model
node_admin_service -.->|"provides"| node_admin_client
node_topic_analysis -->|"loads topics"| node_topics
node_topic_analysis -->|"uses group service"| node_consumer_groups
node_topic_analysis -->|"consumes records"| node_message_tools
node_acls -->|"requests clients"| node_admin_service
node_rbac -->|"reads user"| node_authentication
node_topics -.->|"manages topics"| node_kafka
node_consumer_groups -.->|"reads groups"| node_kafka
node_schema_registry -.->|"supports schemas"| node_kafka
node_connect -.->|"integrates"| node_kafka
node_ksql -.->|"queries streams"| node_kafka

click node_web "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-react-app/src/components/App.tsx"
click node_api "https://github.com/provectus/kafka-ui/tree/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/controller"
click node_cluster_config "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/config/ClustersProperties.java"
click node_cluster_model "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/model/KafkaCluster.java"
click node_topics "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/TopicsService.java"
click node_topic_model "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/model/InternalTopic.java"
click node_admin_service "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/AdminClientService.java"
click node_admin_client "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/ReactiveAdminClient.java"
click node_consumer_groups "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/ConsumerGroupService.java"
click node_brokers_metrics "https://github.com/provectus/kafka-ui/tree/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/metrics"
click node_message_tools "https://github.com/provectus/kafka-ui/tree/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/emitter"
click node_schema_registry "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/SchemaRegistryService.java"
click node_connect "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/KafkaConnectService.java"
click node_ksql "https://github.com/provectus/kafka-ui/tree/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/ksql"
click node_acls "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/acl/AclsService.java"
click node_authentication "https://github.com/provectus/kafka-ui/tree/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/config/auth"
click node_rbac "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/rbac/AccessControlService.java"
click node_masking "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/masking/DataMasking.java"
click node_topic_analysis "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/analyze/TopicAnalysisService.java"
click node_audit "https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/audit/AuditService.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_web,node_api,node_user toneBlue
class node_cluster_config,node_cluster_model,node_topics,node_topic_model,node_admin_service,node_admin_client,node_consumer_groups,node_kafka toneAmber
class node_message_tools,node_schema_registry,node_connect,node_ksql toneMint
class node_acls,node_authentication,node_rbac,node_masking,node_audit toneRose
class node_brokers_metrics,node_topic_analysis toneIndigo
```

## Components

### Web experience

- [Web application](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-react-app/src/components/App.tsx): `kafka-ui-react-app/src/components/App.tsx`
- [HTTP API](https://github.com/provectus/kafka-ui/tree/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/controller): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/controller`

### Cluster operations

- [Cluster configuration](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/config/ClustersProperties.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/config/ClustersProperties.java`
- [Cluster context](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/model/KafkaCluster.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/model/KafkaCluster.java`
- [Topics](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/TopicsService.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/TopicsService.java`
- [Topic representation](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/model/InternalTopic.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/model/InternalTopic.java`
- [Admin client service](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/AdminClientService.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/AdminClientService.java`
- [Reactive Kafka admin](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/ReactiveAdminClient.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/ReactiveAdminClient.java`
- [Consumer groups](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/ConsumerGroupService.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/ConsumerGroupService.java`

### Kafka integrations

- [Message browsing and serdes](https://github.com/provectus/kafka-ui/tree/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/emitter): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/emitter`
- [Schema registry](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/SchemaRegistryService.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/SchemaRegistryService.java`
- [Kafka Connect](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/KafkaConnectService.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/KafkaConnectService.java`
- [ksqlDB](https://github.com/provectus/kafka-ui/tree/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/ksql): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/ksql`

### Security and governance

- [ACL management](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/acl/AclsService.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/acl/AclsService.java`
- [Authentication](https://github.com/provectus/kafka-ui/tree/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/config/auth): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/config/auth`
- [Role-based access](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/rbac/AccessControlService.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/rbac/AccessControlService.java`
- [Data masking](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/masking/DataMasking.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/masking/DataMasking.java`
- [Audit logging](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/audit/AuditService.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/audit/AuditService.java`

### Observability and analysis

- [Broker metrics](https://github.com/provectus/kafka-ui/tree/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/metrics): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/metrics`
- [Topic analysis](https://github.com/provectus/kafka-ui/blob/master/kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/analyze/TopicAnalysisService.java): `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/analyze/TopicAnalysisService.java`

### Other components

- **Kafka UI user**
- **Apache Kafka cluster**

## Connections

- Kafka UI user → Web application: uses (evidence: `README.md`)
- Web application → HTTP API: requests
- Topics → Admin client service: requests clients (evidence: `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/TopicsService.java`)
- Topics → Topic representation: builds (evidence: `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/TopicsService.java`)
- Admin client service → Reactive Kafka admin: provides (evidence: `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/AdminClientService.java`)
- Topic analysis → Topics: loads topics (evidence: `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/analyze/TopicAnalysisService.java`)
- Topic analysis → Consumer groups: uses group service (evidence: `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/analyze/TopicAnalysisService.java`)
- Topic analysis → Message browsing and serdes: consumes records (evidence: `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/analyze/TopicAnalysisService.java`)
- ACL management → Admin client service: requests clients (evidence: `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/acl/AclsService.java`)
- Role-based access → Authentication: reads user (evidence: `kafka-ui-api/src/main/java/com/provectus/kafka/ui/service/rbac/AccessControlService.java`)
- Topics → Apache Kafka cluster: manages topics
- Consumer groups → Apache Kafka cluster: reads groups
- Schema registry → Apache Kafka cluster: supports schemas
- Kafka Connect → Apache Kafka cluster: integrates
- ksqlDB → Apache Kafka cluster: queries streams
