# elastic/kibana architecture

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

- Interactive diagram: https://gitdiagram.com/elastic/kibana
- Repository: https://github.com/elastic/kibana

## Overview

Kibana is a browser-based interface for querying, analyzing, visualizing, and managing data in Elasticsearch. The broad user workflow is documented, but the sampled sources expose only selected implementation details, so the graph shows the documented product flow separately from evidenced internal calls. It includes query state and saved-query services, Discover tab state, field preview, and workflow execution/log-query services. Major product areas beyond these samples are represented at directory level; their internal connections are not inferred.

Main entry points: [`src/platform/plugins/shared/workflows_management/server/services/workflow_execution_query_service.ts`](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_management/server/services/workflow_execution_query_service.ts) (Execution query service), [`src/platform/plugins/shared/data/common/query/persistable_state.ts`](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/common/query/persistable_state.ts) (Query state format), [`src/platform/plugins/shared/data/public/query/query_service.ts`](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/public/query/query_service.ts) (Query state service), [`src/platform/plugins/shared/data/server/query/query_service.ts`](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/server/query/query_service.ts) (Saved query service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_explore["Query and explore"]
  node_query_ui["Query state service<br/>[query_service.ts]"]
  node_discover_tabs["Discover tab state"]
  node_field_preview["Field preview"]
end

subgraph group_data["Data services"]
  node_query_server["Saved query service<br/>[query_service.ts]"]
  node_query_routes["Saved query routes<br/>[routes.ts]"]
  node_query_state["Query state format"]
  node_content_management["Content management"]
end

subgraph group_automation["Workflow operations"]
  node_workflow_query["Execution query service"]
  node_workflow_search["Workflow searches"]
  node_step_search["Step searches"]
  node_logs_query["Workflow log queries"]
  node_logs_repo["Logs repository<br/>[index.ts]"]
  node_templating["Workflow templating"]
end

subgraph group_apm["APM APIs"]
  node_apm_ingestion["Ingestion type route"]
  node_apm_mixed["Mixed ingestion route"]
end

node_user(("Kibana user"))
node_kibana["Kibana interface"]
node_elasticsearch[("Elasticsearch")]

node_user -->|"uses interface"| node_kibana
node_kibana -->|"queries and manages data"| node_elasticsearch
node_query_ui -->|"migrates state"| node_query_state
node_query_server -->|"provides persistence"| node_query_state
node_workflow_query -->|"searches executions"| node_workflow_search
node_workflow_query -->|"searches steps"| node_step_search
node_logs_query -->|"searches logs"| node_logs_repo

click node_query_ui "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/public/query/query_service.ts"
click node_discover_tabs "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/discover/public/application/main/state_management/tabs_storage_manager.ts"
click node_field_preview "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data_view_field_editor/public/components/preview/preview_controller.tsx"
click node_query_server "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/server/query/query_service.ts"
click node_query_routes "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/server/query/routes.ts"
click node_query_state "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/common/query/persistable_state.ts"
click node_workflow_query "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_management/server/services/workflow_execution_query_service.ts"
click node_workflow_search "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_management/server/api/lib/search_workflow_executions.ts"
click node_step_search "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_management/server/api/lib/search_step_executions.ts"
click node_logs_query "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_execution_engine/server/workflow_event_logger/workflow_logs_query_service.ts"
click node_logs_repo "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_execution_engine/server/repositories/logs_repository/index.ts"
click node_templating "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_execution_engine/server/templating_engine.ts"
click node_apm_ingestion "https://github.com/elastic/kibana/blob/main/x-pack/platform/packages/shared/kbn-apm-api-shared/src/routes/services/service_ingestion_type.ts"
click node_apm_mixed "https://github.com/elastic/kibana/blob/main/x-pack/platform/packages/shared/kbn-apm-api-shared/src/routes/services/service_mixed_ingestion.ts"
click node_content_management "https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/content_management/public/content_client/content_client_query_hooks.tsx"

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_query_ui,node_discover_tabs,node_field_preview,node_user toneBlue
class node_query_server,node_query_routes,node_query_state,node_content_management,node_elasticsearch toneAmber
class node_workflow_query,node_workflow_search,node_step_search,node_logs_query,node_logs_repo,node_templating toneMint
class node_apm_ingestion,node_apm_mixed toneRose
class node_kibana toneIndigo
```

## Components

### Query and explore

- [Query state service](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/public/query/query_service.ts): `src/platform/plugins/shared/data/public/query/query_service.ts`
- [Discover tab state](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/discover/public/application/main/state_management/tabs_storage_manager.ts): `src/platform/plugins/shared/discover/public/application/main/state_management/tabs_storage_manager.ts`
- [Field preview](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data_view_field_editor/public/components/preview/preview_controller.tsx): `src/platform/plugins/shared/data_view_field_editor/public/components/preview/preview_controller.tsx`

### Data services

- [Saved query service](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/server/query/query_service.ts): `src/platform/plugins/shared/data/server/query/query_service.ts`
- [Saved query routes](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/server/query/routes.ts): `src/platform/plugins/shared/data/server/query/routes.ts`
- [Query state format](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/data/common/query/persistable_state.ts): `src/platform/plugins/shared/data/common/query/persistable_state.ts`
- [Content management](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/content_management/public/content_client/content_client_query_hooks.tsx): `src/platform/plugins/shared/content_management/public/content_client/content_client_query_hooks.tsx`

### Workflow operations

- [Execution query service](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_management/server/services/workflow_execution_query_service.ts): `src/platform/plugins/shared/workflows_management/server/services/workflow_execution_query_service.ts`
- [Workflow searches](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_management/server/api/lib/search_workflow_executions.ts): `src/platform/plugins/shared/workflows_management/server/api/lib/search_workflow_executions.ts`
- [Step searches](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_management/server/api/lib/search_step_executions.ts): `src/platform/plugins/shared/workflows_management/server/api/lib/search_step_executions.ts`
- [Workflow log queries](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_execution_engine/server/workflow_event_logger/workflow_logs_query_service.ts): `src/platform/plugins/shared/workflows_execution_engine/server/workflow_event_logger/workflow_logs_query_service.ts`
- [Logs repository](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_execution_engine/server/repositories/logs_repository/index.ts): `src/platform/plugins/shared/workflows_execution_engine/server/repositories/logs_repository/index.ts`
- [Workflow templating](https://github.com/elastic/kibana/blob/main/src/platform/plugins/shared/workflows_execution_engine/server/templating_engine.ts): `src/platform/plugins/shared/workflows_execution_engine/server/templating_engine.ts`

### APM APIs

- [Ingestion type route](https://github.com/elastic/kibana/blob/main/x-pack/platform/packages/shared/kbn-apm-api-shared/src/routes/services/service_ingestion_type.ts): `x-pack/platform/packages/shared/kbn-apm-api-shared/src/routes/services/service_ingestion_type.ts`
- [Mixed ingestion route](https://github.com/elastic/kibana/blob/main/x-pack/platform/packages/shared/kbn-apm-api-shared/src/routes/services/service_mixed_ingestion.ts): `x-pack/platform/packages/shared/kbn-apm-api-shared/src/routes/services/service_mixed_ingestion.ts`

### Other components

- **Kibana user**
- **Kibana interface**
- **Elasticsearch**

## Connections

- Kibana user → Kibana interface: uses interface
- Kibana interface → Elasticsearch: queries and manages data
- Query state service → Query state format: migrates state (evidence: `src/platform/plugins/shared/data/public/query/query_service.ts`)
- Saved query service → Query state format: provides persistence (evidence: `src/platform/plugins/shared/data/server/query/query_service.ts`)
- Execution query service → Workflow searches: searches executions (evidence: `src/platform/plugins/shared/workflows_management/server/services/workflow_execution_query_service.ts`)
- Execution query service → Step searches: searches steps (evidence: `src/platform/plugins/shared/workflows_management/server/services/workflow_execution_query_service.ts`)
- Workflow log queries → Logs repository: searches logs (evidence: `src/platform/plugins/shared/workflows_execution_engine/server/workflow_event_logger/workflow_logs_query_service.ts`)
