# open-telemetry/opentelemetry-helm-charts architecture

> Architecture diagram of the GitHub repository open-telemetry/opentelemetry-helm-charts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/open-telemetry/opentelemetry-helm-charts
- Repository: https://github.com/open-telemetry/opentelemetry-helm-charts

## Overview

This repository packages OpenTelemetry products as Helm charts. A cluster operator uses Helm to install a selected chart into Kubernetes; the chart renders the resources needed to deploy that product. The README documents Collector, Demo, Operator, and eBPF Instrumentation charts. The tree also includes kube-stack, eBPF, and Target Allocator charts. No source excerpts were supplied, so the graph shows documented chart-install relationships and avoids claiming internal runtime wiring.

Main entry points: [`charts/opentelemetry-collector`](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-collector) (Collector chart), [`charts/opentelemetry-demo`](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-demo) (Demo chart), [`charts/opentelemetry-ebpf-instrumentation`](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-ebpf-instrumentation) (eBPF instrumentation chart), [`charts/opentelemetry-operator`](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-operator) (Operator chart)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Telemetry Collection"]
  node_collector["Collector chart"]
  node_collector_workload["Collector deployment"]
  node_target_allocator["Target Allocator chart"]
end

subgraph group_demo["Demo"]
  node_demo_chart["Demo chart"]
  node_demo_workload["Demo deployment"]
end

subgraph group_instrumentation["Instrumentation"]
  node_ebpf_instrumentation["eBPF instrumentation chart"]
  node_ebpf_workload["eBPF instrumentation"]
  node_ebpf_chart["eBPF chart"]
end

subgraph group_platform["Kubernetes Platform"]
  node_operator_chart["Operator chart"]
  node_operator_workload["Operator deployment"]
  node_kube_stack["Kube stack chart"]
end

node_operator(("Cluster operator"))
node_helm["Helm"]
node_kubernetes["Kubernetes cluster"]

node_operator -->|"invokes"| node_helm
node_helm -->|"installs"| node_collector
node_helm -->|"installs"| node_demo_chart
node_helm -->|"installs"| node_operator_chart
node_helm -->|"installs"| node_ebpf_instrumentation
node_helm -->|"installs"| node_ebpf_chart
node_helm -->|"installs"| node_kube_stack
node_helm -->|"installs"| node_target_allocator
node_collector -->|"renders"| node_collector_workload
node_demo_chart -->|"renders"| node_demo_workload
node_operator_chart -->|"renders"| node_operator_workload
node_ebpf_instrumentation -->|"renders"| node_ebpf_workload
node_collector_workload -->|"deploys to"| node_kubernetes
node_demo_workload -->|"deploys to"| node_kubernetes
node_operator_workload -->|"deploys to"| node_kubernetes

click node_collector "https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-collector"
click node_demo_chart "https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-demo"
click node_operator_chart "https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-operator"
click node_ebpf_instrumentation "https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-ebpf-instrumentation"
click node_ebpf_chart "https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-ebpf"
click node_kube_stack "https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-kube-stack"
click node_target_allocator "https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-target-allocator"

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_collector,node_collector_workload,node_target_allocator toneBlue
class node_demo_chart,node_demo_workload toneAmber
class node_ebpf_instrumentation,node_ebpf_workload,node_ebpf_chart toneMint
class node_operator_chart,node_operator_workload,node_kube_stack toneRose
class node_operator,node_helm,node_kubernetes toneIndigo
```

## Components

### Telemetry Collection

- [Collector chart](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-collector): `charts/opentelemetry-collector`
- **Collector deployment**
- [Target Allocator chart](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-target-allocator): `charts/opentelemetry-target-allocator`

### Demo

- [Demo chart](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-demo): `charts/opentelemetry-demo`
- **Demo deployment**

### Instrumentation

- [eBPF instrumentation chart](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-ebpf-instrumentation): `charts/opentelemetry-ebpf-instrumentation`
- **eBPF instrumentation**
- [eBPF chart](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-ebpf): `charts/opentelemetry-ebpf`

### Kubernetes Platform

- [Operator chart](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-operator): `charts/opentelemetry-operator`
- **Operator deployment**
- [Kube stack chart](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-kube-stack): `charts/opentelemetry-kube-stack`

### Other components

- **Cluster operator**
- **Helm**
- **Kubernetes cluster**

## Connections

- Cluster operator → Helm: invokes
- Helm → Collector chart: installs
- Helm → Demo chart: installs
- Helm → Operator chart: installs
- Helm → eBPF instrumentation chart: installs
- Helm → eBPF chart: installs
- Helm → Kube stack chart: installs
- Helm → Target Allocator chart: installs
- Collector chart → Collector deployment: renders
- Demo chart → Demo deployment: renders
- Operator chart → Operator deployment: renders
- eBPF instrumentation chart → eBPF instrumentation: renders
- Collector deployment → Kubernetes cluster: deploys to
- Demo deployment → Kubernetes cluster: deploys to
- Operator deployment → Kubernetes cluster: deploys to