# wazuh/wazuh-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/wazuh/wazuh-dashboard
- Repository: https://github.com/wazuh/wazuh-dashboard

## Overview

This is the OpenSearch Dashboards platform, forked by Wazuh as the platform for its separate UI. Its principal workflow is browser users composing a query, the data plugin combining query and filter/time state into an OpenSearch request, and the platform serving requests and connecting to OpenSearch. The tree also shows visualization, APM topology, Explore, agent-trace, and agent capabilities. Sampled evidence is strongest for query construction and cookie-backed session handling; several broader subsystem links are therefore shown as unverified.

Main entry points: [`src/plugins/data/public/query/query_service.ts`](https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/query/query_service.ts) (Query service), [`src/core/server/http/router/router.ts`](https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/http/router/router.ts) (HTTP router), [`src/plugins/data/public/ui/search_bar/lib/use_query_string_manager.ts`](https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/ui/search_bar/lib/use_query_string_manager.ts) (Query interface), [`src/plugins/data/public/query/query_string/query_string_manager.ts`](https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/query/query_string/query_string_manager.ts) (Query state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_query_ui["Query interface"]
  node_visualizations["Visualizations"]
  node_explore["Explore"]
end

subgraph group_data["Data and queries"]
  node_query_service["Query service<br/>[query_service.ts]"]
  node_query_manager["Query state"]
  node_saved_queries["Saved queries"]
  node_query_builder["OpenSearch query builder"]
  node_data_services["Data services<br/>[services.ts]"]
end

subgraph group_core["Platform services"]
  node_router["HTTP router<br/>[router.ts]"]
  node_http_service["HTTP service<br/>[http_service.ts]"]
  node_cookie_sessions["Cookie sessions"]
  node_auth_state["Auth state"]
  node_opensearch_service["OpenSearch service"]
end

subgraph group_observability["Observability and agents"]
  node_topology["APM topology"]
  node_agent_traces["Agent traces"]
  node_agents["Agents"]
end

node_user(("Browser user"))
node_opensearch[("OpenSearch")]
node_http_client(("Browser requests"))

node_user -.->|"composes query"| node_query_ui
node_query_ui -.->|"uses query state"| node_query_service
node_query_service -->|"creates and uses"| node_query_manager
node_query_service -->|"creates service"| node_saved_queries
node_query_service -->|"builds request"| node_query_builder
node_query_manager -->|"gets application"| node_data_services
node_saved_queries -->|"reads UI setting"| node_data_services
node_query_builder -.->|"submits search"| node_opensearch
node_http_client -.->|"sends requests"| node_http_service
node_http_service -.->|"routes requests"| node_router
node_cookie_sessions -->|"normalizes request"| node_router
node_auth_state -->|"normalizes request"| node_router
node_opensearch_service -.->|"connects to"| node_opensearch
node_visualizations -.->|"uses data queries"| node_query_service
node_explore -.->|"uses data queries"| node_query_service
node_agent_traces -.->|"uses data queries"| node_query_service

click node_query_ui "https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/ui/search_bar/lib/use_query_string_manager.ts"
click node_query_service "https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/query/query_service.ts"
click node_query_manager "https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/query/query_string/query_string_manager.ts"
click node_saved_queries "https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/query/saved_query/saved_query_service.ts"
click node_query_builder "https://github.com/wazuh/wazuh-dashboard/tree/main/src/plugins/data/common/opensearch_query"
click node_data_services "https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/services.ts"
click node_router "https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/http/router/router.ts"
click node_http_service "https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/http/http_service.ts"
click node_cookie_sessions "https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/http/cookie_session_storage.ts"
click node_auth_state "https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/http/auth_state_storage.ts"
click node_opensearch_service "https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/opensearch/opensearch_service.ts"
click node_visualizations "https://github.com/wazuh/wazuh-dashboard/tree/main/src/plugins/visualizations/public"
click node_explore "https://github.com/wazuh/wazuh-dashboard/tree/main/src/plugins/explore/public"
click node_topology "https://github.com/wazuh/wazuh-dashboard/tree/main/packages/osd-apm-topology/src"
click node_agent_traces "https://github.com/wazuh/wazuh-dashboard/tree/main/src/plugins/agent_traces/public"
click node_agents "https://github.com/wazuh/wazuh-dashboard/tree/main/packages/osd-agents/src"

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_visualizations,node_explore,node_user,node_http_client toneBlue
class node_query_service,node_query_manager,node_saved_queries,node_query_builder,node_data_services,node_opensearch toneAmber
class node_router,node_http_service,node_cookie_sessions,node_auth_state,node_opensearch_service toneMint
class node_topology,node_agent_traces,node_agents toneRose
```

## Components

### User experience

- [Query interface](https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/ui/search_bar/lib/use_query_string_manager.ts): `src/plugins/data/public/ui/search_bar/lib/use_query_string_manager.ts`
- [Visualizations](https://github.com/wazuh/wazuh-dashboard/tree/main/src/plugins/visualizations/public): `src/plugins/visualizations/public`
- [Explore](https://github.com/wazuh/wazuh-dashboard/tree/main/src/plugins/explore/public): `src/plugins/explore/public`

### Data and queries

- [Query service](https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/query/query_service.ts): `src/plugins/data/public/query/query_service.ts`
- [Query state](https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/query/query_string/query_string_manager.ts): `src/plugins/data/public/query/query_string/query_string_manager.ts`
- [Saved queries](https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/query/saved_query/saved_query_service.ts): `src/plugins/data/public/query/saved_query/saved_query_service.ts`
- [OpenSearch query builder](https://github.com/wazuh/wazuh-dashboard/tree/main/src/plugins/data/common/opensearch_query): `src/plugins/data/common/opensearch_query`
- [Data services](https://github.com/wazuh/wazuh-dashboard/blob/main/src/plugins/data/public/services.ts): `src/plugins/data/public/services.ts`

### Platform services

- [HTTP router](https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/http/router/router.ts): `src/core/server/http/router/router.ts`
- [HTTP service](https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/http/http_service.ts): `src/core/server/http/http_service.ts`
- [Cookie sessions](https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/http/cookie_session_storage.ts): `src/core/server/http/cookie_session_storage.ts`
- [Auth state](https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/http/auth_state_storage.ts): `src/core/server/http/auth_state_storage.ts`
- [OpenSearch service](https://github.com/wazuh/wazuh-dashboard/blob/main/src/core/server/opensearch/opensearch_service.ts): `src/core/server/opensearch/opensearch_service.ts`

### Observability and agents

- [APM topology](https://github.com/wazuh/wazuh-dashboard/tree/main/packages/osd-apm-topology/src): `packages/osd-apm-topology/src`
- [Agent traces](https://github.com/wazuh/wazuh-dashboard/tree/main/src/plugins/agent_traces/public): `src/plugins/agent_traces/public`
- [Agents](https://github.com/wazuh/wazuh-dashboard/tree/main/packages/osd-agents/src): `packages/osd-agents/src`

### Other components

- **Browser user**
- **OpenSearch**
- **Browser requests**

## Connections

- Browser user → Query interface: composes query
- Query interface → Query service: uses query state
- Query service → Query state: creates and uses (evidence: `src/plugins/data/public/query/query_service.ts`)
- Query service → Saved queries: creates service (evidence: `src/plugins/data/public/query/query_service.ts`)
- Query service → OpenSearch query builder: builds request (evidence: `src/plugins/data/public/query/query_service.ts`)
- Query state → Data services: gets application (evidence: `src/plugins/data/public/query/query_string/query_string_manager.ts`)
- Saved queries → Data services: reads UI setting (evidence: `src/plugins/data/public/query/saved_query/saved_query_service.ts`)
- OpenSearch query builder → OpenSearch: submits search
- Browser requests → HTTP service: sends requests
- HTTP service → HTTP router: routes requests
- Cookie sessions → HTTP router: normalizes request (evidence: `src/core/server/http/cookie_session_storage.ts`)
- Auth state → HTTP router: normalizes request (evidence: `src/core/server/http/auth_state_storage.ts`)
- OpenSearch service → OpenSearch: connects to
- Visualizations → Query service: uses data queries
- Explore → Query service: uses data queries
- Agent traces → Query service: uses data queries
