# observiq/bindplane-otel-collector architecture

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

- Interactive diagram: https://gitdiagram.com/observiq/bindplane-otel-collector
- Repository: https://github.com/observiq/bindplane-otel-collector

## Overview

##### Main Components

a. Core Components:
- OpenTelemetry Collector Core
- Receivers Layer
- Processors Layer
- Exporters Layer
- Extensions Layer
- Connectors Layer

b. Management Components:
- OpAMP Client
- Configuration Management
- Service Management
- Update Management

c. Integration Points:
- BindPlane Telemetry Pipeline
- Various Data Sources
- Multiple Export Destinations

**┌─────────────────────────────────────────────────────────┐**
- Management Layer                        │
- [OpAMP Client] ←→ [Config Manager] ←→ [Update Manager] │
- ┤
- Pipeline Layer                          │

- ┌─────────┐    ┌──────────┐    ┌──────────┐          │
- Receivers│ →  │Processors│ →  │Exporters │          │
- ┘    └──────────┘    └──────────┘          │

- ┤
- Extension Layer                         │
- [Service Management] [Connectors] [Other Extensions] │
- ┘

##### Connection Types

Use different line styles to represent:

##### Component Details

For each major component, include:
- Component name
- Primary function
- Key interfaces
- Configuration dependencies

##### Specific Implementation Details

- Plugin system (from /plugins directory)
- Multiple exporter options (from /exporter directory)
- Various receiver implementations (from /receiver directory)
- Processor chain capabilities (from /processor directory)

##### External Interactions

Connections to:
- BindPlane Telemetry Pipeline
- Cloud providers (Google Cloud, Azure, etc.)
- Monitoring systems
- Log aggregators

##### Management Interfaces

Represent:
- OpAMP protocol implementation
- Configuration management
- Service lifecycle management
- Update mechanisms

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Management
        OpAMP["OpAMP Client"]:::management
        Config["Configuration Manager"]:::management
        Update["Update Manager"]:::management
        Service["Service Manager"]:::management

        OpAMP <--> Config
        Config <--> Update
        Config <--> Service
    end

    subgraph Pipeline
        subgraph Receivers
            RecCore["Receivers Layer"]:::receiver
        end

        subgraph Processors
            ProcCore["Processors Layer"]:::processor
            Topology["Topology Processor"]:::processor
            MetricStats["Metrics Stats Processor"]:::processor
        end

        subgraph Exporters
            ExpCore["Exporters Layer"]:::exporter
            GCloud["Google Cloud Exporter"]:::exporter
            Azure["Azure Blob Exporter"]:::exporter
        end

        RecCore --> ProcCore
        ProcCore --> ExpCore
        ProcCore --> Topology
        ProcCore --> MetricStats
        Topology --> ExpCore
        MetricStats --> ExpCore
        ExpCore --> GCloud
        ExpCore --> Azure
    end

    subgraph Extensions
        ExtCore["Extensions Layer"]:::extension
        BPExt["BindPlane Extension"]:::extension
        Plugin["Plugin System"]:::extension
    end

    subgraph Internal
        Measure["Telemetry Pipeline"]:::internal
        Logging["Logging System"]:::internal
        ServiceImpl["Service Implementation"]:::internal
        Rehydration["Rehydration System"]:::internal
    end

    OTCore["OpenTelemetry Collector Core"]:::core

    OTCore --> Pipeline
    Extensions --> Pipeline
    Management --> Pipeline
    Internal --> Pipeline

    %% Click Events
    click OTCore "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/collector"
    click RecCore "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/receiver"
    click ProcCore "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/processor"
    click ExpCore "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/exporter"
    click ExtCore "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/extension"
    click OpAMP "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/opamp"
    click Config "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/config"
    click Service "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/service"
    click Update "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/updater"
    click Plugin "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/plugins"
    click Measure "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/internal/measurements"
    click Logging "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/internal/logging"
    click ServiceImpl "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/internal/service"
    click Topology "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/processor/topologyprocessor"
    click MetricStats "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/processor/metricstatsprocessor"
    click GCloud "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/exporter/googlecloudexporter"
    click Azure "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/exporter/azureblobexporter"
    click BPExt "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/extension/bindplaneextension"
    click Rehydration "https://github.com/observIQ/bindplane-otel-collector/tree/release/v1.69.0/internal/rehydration"

    %% Styles
    classDef core fill:#1E88E5,stroke:#0D47A1,color:white
    classDef management fill:#9C27B0,stroke:#6A1B9A,color:white
    classDef receiver fill:#4CAF50,stroke:#2E7D32,color:white
    classDef processor fill:#FFC107,stroke:#FFA000,color:black
    classDef exporter fill:#F44336,stroke:#C62828,color:white
    classDef extension fill:#607D8B,stroke:#455A64,color:white
    classDef internal fill:#795548,stroke:#4E342E,color:white

    %% Legend
    subgraph Legend
        L1["Core Component"]:::core
        L2["Management Component"]:::management
        L3["Receiver Component"]:::receiver
        L4["Processor Component"]:::processor
        L5["Exporter Component"]:::exporter
        L6["Extension Component"]:::extension
        L7["Internal Component"]:::internal
    end
```
