# open-telemetry/opentelemetry-operator architecture

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

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

## Overview

##### Main Components

a. Core Components:
- OpenTelemetry Operator Controller
- Custom Resource Definitions (CRDs)
- OpenTelemetryCollector
- Instrumentation
- OpAMPBridge
- Target Allocator
- Auto-instrumentation Components

b. External Dependencies:
- Kubernetes API Server
- cert-manager
- Prometheus Operator (optional)
- OpenTelemetry Collector

- Kubernetes Cluster                                      |

- Cert Manager    |    | OpenTelemetry       |    |  Prometheus Operator   |        |
- Operator Controller  |    |  (Optional)            |        |

- Custom Resources      |                                    |
- OpenTelemetryCol.   |                                    |
- Instrumentation     |                                    |
- OpAMPBridge        |                                    |

- Managed Components                                         |

- OpenTelemetry    |    |  Target Allocator    |    |  Auto-instrumentation  |        |
- Collector Pods    |<-->|  (Optional)         |    |  Injected Sidecars     |        |

- ^                                                        ^                    |

- v                                                        v                    |

- Monitored        |                                   | Instrumented      |          |
- Services         |                                   | Applications      |          |

##### Additional Details

Callouts for:
- Supported instrumentation languages (Java, Python, .NET, Node.js, Go)
- Deployment modes (Deployment, DaemonSet, StatefulSet, Sidecar)
- Configuration flow
- Resource attribute injection

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Kubernetes["Kubernetes Cluster"]
        subgraph ControlPlane["Control Plane"]
            CertManager["Cert Manager"]
            PrometheusOp["Prometheus Operator"]:::optional
            
            subgraph Operator["OpenTelemetry Operator"]
                Controller["Controller"]:::core
                click Controller "https://github.com/open-telemetry/opentelemetry-operator/blob/main/controllers/opentelemetrycollector_controller.go"
                
                subgraph CRDs["Custom Resources"]
                    OtelCol["OpenTelemetryCollector CRD"]:::crd
                    click OtelCol "https://github.com/open-telemetry/opentelemetry-operator/blob/main/apis/v1beta1/opentelemetrycollector_types.go"
                    Instr["Instrumentation CRD"]:::crd
                    click Instr "https://github.com/open-telemetry/opentelemetry-operator/blob/main/apis/v1alpha1/instrumentation_types.go"
                    OpAMP["OpAMPBridge CRD"]:::crd
                    click OpAMP "https://github.com/open-telemetry/opentelemetry-operator/blob/main/apis/v1alpha1/opampbridge_types.go"
                end
                
                WebHook["Webhook Handlers"]:::core
                click WebHook "https://github.com/open-telemetry/opentelemetry-operator/blob/main/internal/webhook/podmutation/webhookhandler.go"
                ConfigMgmt["Configuration Management"]:::core
                click ConfigMgmt "https://github.com/open-telemetry/opentelemetry-operator/tree/main/internal/config/"
                ManifestMgmt["Manifest Management"]:::core
                click ManifestMgmt "https://github.com/open-telemetry/opentelemetry-operator/tree/main/internal/manifests/"
                Metrics["Operator Metrics"]:::core
                click Metrics "https://github.com/open-telemetry/opentelemetry-operator/blob/main/internal/operator-metrics/metrics.go"
            end
        end
        
        subgraph DataPlane["Data Plane"]
            subgraph ManagedComponents["Managed Components"]
                CollectorPods["OpenTelemetry Collector Pods"]:::managed
                TargetAlloc["Target Allocator"]:::managed
                click TargetAlloc "https://github.com/open-telemetry/opentelemetry-operator/tree/main/cmd/otel-allocator/"
                OpAMPBridge["OpAMP Bridge"]:::managed
                click OpAMPBridge "https://github.com/open-telemetry/opentelemetry-operator/tree/main/cmd/operator-opamp-bridge/"
                
                subgraph AutoInstr["Auto-instrumentation"]
                    Java["Java Agent"]:::instrument
                    click Java "https://github.com/open-telemetry/opentelemetry-operator/tree/main/autoinstrumentation/java/"
                    Python["Python Agent"]:::instrument
                    click Python "https://github.com/open-telemetry/opentelemetry-operator/tree/main/autoinstrumentation/python/"
                    DotNet[".NET Agent"]:::instrument
                    click DotNet "https://github.com/open-telemetry/opentelemetry-operator/tree/main/autoinstrumentation/dotnet/"
                    NodeJS["NodeJS Agent"]:::instrument
                    click NodeJS "https://github.com/open-telemetry/opentelemetry-operator/tree/main/autoinstrumentation/nodejs/"
                    Apache["Apache HTTPD Agent"]:::instrument
                    click Apache "https://github.com/open-telemetry/opentelemetry-operator/tree/main/autoinstrumentation/apache-httpd/"
                end
            end
            
            Apps["Instrumented Applications"]:::app
            Services["Monitored Services"]:::app
        end
    end
    
    %% Relationships
    Controller --> CRDs
    Controller --> WebHook
    Controller --> ConfigMgmt
    Controller --> ManifestMgmt
    Controller --> Metrics
    
    WebHook --> CollectorPods
    WebHook --> AutoInstr
    
    CollectorPods <--> TargetAlloc
    CollectorPods --> Services
    
    AutoInstr --> Apps
    
    %% Styling
    classDef core fill:#2374e1,color:#fff
    classDef crd fill:#37a2eb,color:#fff
    classDef managed fill:#68d391,color:#000
    classDef instrument fill:#f6ad55,color:#000
    classDef app fill:#cbd5e0,color:#000
    classDef optional fill:#e2e8f0,color:#000
    
    %% Legend
    subgraph Legend
        CoreComp["Core Component"]:::core
        CRDComp["Custom Resource Definition"]:::crd
        ManagedComp["Managed Component"]:::managed
        InstrComp["Instrumentation Agent"]:::instrument
        AppComp["Application/Service"]:::app
        OptionalComp["Optional Component"]:::optional
    end
```
