# grafana/grafana-llm-app architecture

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

- Interactive diagram: https://gitdiagram.com/grafana/grafana-llm-app
- Repository: https://github.com/grafana/grafana-llm-app

## Overview

Grafana LLM is a Grafana app plugin paired with the `@grafana/llm` client library. The user configures an LLM provider and optional vector services in the app; applications then use the client library to reach the plugin for chat and health checks. The app also exposes model and MCP-tool views, with a development sandbox for exercising tools. The README documents provider, vector, and MCP capabilities; several backend connections are not shown in sampled code, so those links are dashed and unverified.

Main entry points: [`packages/grafana-llm-app/src/components/AppConfig/AppConfig.tsx`](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/AppConfig.tsx) (Plugin configuration), [`packages/grafana-llm-app/pkg/plugin/vector/service.go`](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/vector/service.go) (Vector service), [`packages/grafana-llm-app/src/components/AppConfig/Vector.tsx`](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/Vector.tsx) (Vector settings), [`packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandbox.tsx`](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandbox.tsx) (Developer sandbox)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_ui["Grafana app UI"]
  node_config_page["Plugin configuration<br/>[AppConfig.tsx]"]
  node_provider_config["Provider settings<br/>[LLMConfig.tsx]"]
  node_model_config["Model settings<br/>[ModelConfig.tsx]"]
  node_health_ui["Health check UI<br/>[HealthCheck.tsx]"]
  node_vector_config["Vector settings<br/>[Vector.tsx]"]
  node_basic_auth["Vector credentials<br/>[BasicAuth.tsx]"]
  node_sandbox["Developer sandbox<br/>[DevSandbox.tsx]"]
  node_sandbox_chat["Sandbox chat<br/>[DevSandboxChat.tsx]"]
  node_tool_inspector["Tool inspector"]
  node_tool_form["Tool parameter form"]
  node_main_page["Plugin main page<br/>[MainPage.tsx]"]
  node_models_page["Models view<br/>[Models.tsx]"]
  node_mcp_tools_page["MCP tools view<br/>[MCPTools.tsx]"]
end

subgraph group_plugin_backend["Plugin backend"]
  node_plugin_app["Plugin app<br/>[app.go]"]
  node_providers["LLM providers<br/>[llm_provider.go]"]
  node_resources["Plugin resources<br/>[resources.go]"]
  node_streaming["Chat streaming<br/>[stream.go]"]
  node_mcp_server["MCP live server<br/>[live_server.go]"]
end

subgraph group_client_library["Client library"]
  node_llm_client["LLM API client<br/>[llm.ts]"]
  node_mcp_client["MCP client transport<br/>[mcp.tsx]"]
end

subgraph group_vector_services["Vector features"]
  node_vector_service["Vector service<br/>[service.go]"]
  node_embedder["Vector embedding<br/>[openai.go]"]
  node_qdrant[("Qdrant store<br/>[qdrant.go]")]
  node_vector_api["Grafana Vector API<br/>[vectorapi.go]"]
end

node_admin(("Grafana operator"))
node_application(("Grafana application"))
node_grafana_backend["Grafana plugin API"]
node_llm_provider_service["Configured LLM service"]

node_admin -->|"configures"| node_config_page
node_config_page -->|"renders"| node_provider_config
node_config_page -->|"renders"| node_model_config
node_config_page -->|"shows results"| node_health_ui
node_config_page -->|"renders"| node_vector_config
node_vector_config -->|"renders"| node_basic_auth
node_provider_config -->|"renders"| node_sandbox
node_sandbox -->|"renders"| node_sandbox_chat
node_sandbox -->|"renders"| node_tool_inspector
node_tool_inspector -->|"renders"| node_tool_form
node_main_page -->|"renders"| node_models_page
node_main_page -->|"renders"| node_mcp_tools_page
node_application -->|"calls"| node_llm_client
node_llm_client -->|"requests chat and health"| node_grafana_backend
node_grafana_backend -.->|"routes requests"| node_resources
node_resources -.->|"uses provider"| node_providers
node_providers -.->|"requests completions"| node_llm_provider_service
node_resources -.->|"streams responses"| node_streaming
node_application -->|"uses"| node_mcp_client
node_mcp_client -.->|"connects through live transport"| node_grafana_backend
node_grafana_backend -.->|"dispatches MCP"| node_mcp_server
node_vector_config -.->|"configures"| node_vector_service
node_vector_service -.->|"embeds"| node_embedder
node_vector_service -.->|"uses store"| node_qdrant
node_vector_service -.->|"uses store"| node_vector_api

click node_config_page "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/AppConfig.tsx"
click node_provider_config "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/LLMConfig.tsx"
click node_model_config "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/ModelConfig.tsx"
click node_health_ui "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/HealthCheck.tsx"
click node_vector_config "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/Vector.tsx"
click node_basic_auth "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/AuthSettings/BasicAuth.tsx"
click node_sandbox "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandbox.tsx"
click node_sandbox_chat "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandboxChat.tsx"
click node_tool_inspector "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandboxToolInspector.tsx"
click node_tool_form "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/DevSandbox/ToolParameterForm.tsx"
click node_main_page "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/pages/MainPage.tsx"
click node_models_page "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/pages/Models.tsx"
click node_mcp_tools_page "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/pages/MCPTools.tsx"
click node_plugin_app "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/app.go"
click node_providers "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/llm_provider.go"
click node_resources "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/resources.go"
click node_streaming "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/stream.go"
click node_mcp_server "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/mcp/live_server.go"
click node_llm_client "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-frontend/src/llm.ts"
click node_mcp_client "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-frontend/src/mcp.tsx"
click node_vector_service "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/vector/service.go"
click node_embedder "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/vector/embed/openai.go"
click node_qdrant "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/vector/store/qdrant.go"
click node_vector_api "https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/vector/store/vectorapi.go"

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_config_page,node_provider_config,node_model_config,node_health_ui,node_vector_config,node_basic_auth,node_sandbox,node_sandbox_chat,node_tool_inspector,node_tool_form,node_main_page,node_models_page,node_mcp_tools_page toneBlue
class node_plugin_app,node_providers,node_resources,node_streaming,node_mcp_server toneAmber
class node_llm_client,node_mcp_client,node_grafana_backend toneMint
class node_vector_service,node_embedder,node_qdrant,node_vector_api toneRose
class node_admin,node_application,node_llm_provider_service toneIndigo
```

## Components

### Grafana app UI

- [Plugin configuration](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/AppConfig.tsx): `packages/grafana-llm-app/src/components/AppConfig/AppConfig.tsx`
- [Provider settings](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/LLMConfig.tsx): `packages/grafana-llm-app/src/components/AppConfig/LLMConfig.tsx`
- [Model settings](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/ModelConfig.tsx): `packages/grafana-llm-app/src/components/AppConfig/ModelConfig.tsx`
- [Health check UI](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/HealthCheck.tsx): `packages/grafana-llm-app/src/components/AppConfig/HealthCheck.tsx`
- [Vector settings](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/Vector.tsx): `packages/grafana-llm-app/src/components/AppConfig/Vector.tsx`
- [Vector credentials](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/AuthSettings/BasicAuth.tsx): `packages/grafana-llm-app/src/components/AppConfig/AuthSettings/BasicAuth.tsx`
- [Developer sandbox](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandbox.tsx): `packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandbox.tsx`
- [Sandbox chat](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandboxChat.tsx): `packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandboxChat.tsx`
- [Tool inspector](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandboxToolInspector.tsx): `packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandboxToolInspector.tsx`
- [Tool parameter form](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/components/AppConfig/DevSandbox/ToolParameterForm.tsx): `packages/grafana-llm-app/src/components/AppConfig/DevSandbox/ToolParameterForm.tsx`
- [Plugin main page](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/pages/MainPage.tsx): `packages/grafana-llm-app/src/pages/MainPage.tsx`
- [Models view](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/pages/Models.tsx): `packages/grafana-llm-app/src/pages/Models.tsx`
- [MCP tools view](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/src/pages/MCPTools.tsx): `packages/grafana-llm-app/src/pages/MCPTools.tsx`

### Plugin backend

- [Plugin app](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/app.go): `packages/grafana-llm-app/pkg/plugin/app.go`
- [LLM providers](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/llm_provider.go): `packages/grafana-llm-app/pkg/plugin/llm_provider.go`
- [Plugin resources](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/resources.go): `packages/grafana-llm-app/pkg/plugin/resources.go`
- [Chat streaming](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/stream.go): `packages/grafana-llm-app/pkg/plugin/stream.go`
- [MCP live server](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/mcp/live_server.go): `packages/grafana-llm-app/pkg/mcp/live_server.go`

### Client library

- [LLM API client](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-frontend/src/llm.ts): `packages/grafana-llm-frontend/src/llm.ts`
- [MCP client transport](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-frontend/src/mcp.tsx): `packages/grafana-llm-frontend/src/mcp.tsx`

### Vector features

- [Vector service](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/vector/service.go): `packages/grafana-llm-app/pkg/plugin/vector/service.go`
- [Vector embedding](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/vector/embed/openai.go): `packages/grafana-llm-app/pkg/plugin/vector/embed/openai.go`
- [Qdrant store](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/vector/store/qdrant.go): `packages/grafana-llm-app/pkg/plugin/vector/store/qdrant.go`
- [Grafana Vector API](https://github.com/grafana/grafana-llm-app/blob/main/packages/grafana-llm-app/pkg/plugin/vector/store/vectorapi.go): `packages/grafana-llm-app/pkg/plugin/vector/store/vectorapi.go`

### Other components

- **Grafana operator**
- **Grafana application**
- **Grafana plugin API**
- **Configured LLM service**

## Connections

- Grafana operator → Plugin configuration: configures
- Plugin configuration → Provider settings: renders (evidence: `packages/grafana-llm-app/src/components/AppConfig/AppConfig.tsx`)
- Plugin configuration → Model settings: renders (evidence: `packages/grafana-llm-app/src/components/AppConfig/AppConfig.tsx`)
- Plugin configuration → Health check UI: shows results (evidence: `packages/grafana-llm-app/src/components/AppConfig/AppConfig.tsx`)
- Plugin configuration → Vector settings: renders (evidence: `packages/grafana-llm-app/src/components/AppConfig/AppConfig.tsx`)
- Vector settings → Vector credentials: renders (evidence: `packages/grafana-llm-app/src/components/AppConfig/Vector.tsx`)
- Provider settings → Developer sandbox: renders (evidence: `packages/grafana-llm-app/src/components/AppConfig/LLMConfig.tsx`)
- Developer sandbox → Sandbox chat: renders (evidence: `packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandbox.tsx`)
- Developer sandbox → Tool inspector: renders (evidence: `packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandbox.tsx`)
- Tool inspector → Tool parameter form: renders (evidence: `packages/grafana-llm-app/src/components/AppConfig/DevSandbox/DevSandboxToolInspector.tsx`)
- Plugin main page → Models view: renders (evidence: `packages/grafana-llm-app/src/pages/MainPage.tsx`)
- Plugin main page → MCP tools view: renders (evidence: `packages/grafana-llm-app/src/pages/MainPage.tsx`)
- Grafana application → LLM API client: calls (evidence: `packages/grafana-llm-frontend/src/llm.ts`)
- LLM API client → Grafana plugin API: requests chat and health (evidence: `packages/grafana-llm-frontend/src/llm.ts`)
- Grafana plugin API → Plugin resources: routes requests
- Plugin resources → LLM providers: uses provider
- LLM providers → Configured LLM service: requests completions
- Plugin resources → Chat streaming: streams responses
- Grafana application → MCP client transport: uses (evidence: `packages/grafana-llm-frontend/src/mcp.tsx`)
- MCP client transport → Grafana plugin API: connects through live transport
- Grafana plugin API → MCP live server: dispatches MCP
- Vector settings → Vector service: configures
- Vector service → Vector embedding: embeds
- Vector service → Qdrant store: uses store
- Vector service → Grafana Vector API: uses store
