# open-telemetry/opentelemetry-go architecture

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

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

## Overview

OpenTelemetry-Go provides APIs and SDKs for capturing traces, metrics, and logs, then exporting that telemetry to observability backends. The main workflow is application instrumentation, SDK processing and resource association, followed by exporter delivery; propagation carries trace context between services. The graph also preserves semantic conventions and compatibility integrations. The README documents the broad workflow and exporter capabilities; source excerpts and the index support only selected internal connections, so other relationships are marked unverified or omitted.

Main entry points: [`sdk/metric/pipeline.go`](https://github.com/open-telemetry/opentelemetry-go/blob/main/sdk/metric/pipeline.go) (Metric SDK), [`trace.go`](https://github.com/open-telemetry/opentelemetry-go/blob/main/trace.go) (Trace API), [`sdk/trace`](https://github.com/open-telemetry/opentelemetry-go/tree/main/sdk/trace) (Trace SDK), [`sdk/log`](https://github.com/open-telemetry/opentelemetry-go/tree/main/sdk/log) (Log SDK)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Telemetry APIs"]
  node_trace_api["Trace API<br/>[trace.go]"]
  node_metric_api["Metric API<br/>[metric.go]"]
  node_log_api["Log API<br/>[log.go]"]
end

subgraph group_sdk["SDK Processing"]
  node_trace_sdk["Trace SDK"]
  node_metric_sdk["Metric SDK<br/>[pipeline.go]"]
  node_log_sdk["Log SDK"]
  node_resource["Resource detection"]
end

subgraph group_context["Context and Conventions"]
  node_propagation["Trace propagation<br/>[trace_context.go]"]
  node_baggage["Baggage context<br/>[context.go]"]
  node_semconv["Semantic conventions"]
  node_attribute["Attribute types<br/>[value.go]"]
end

subgraph group_export["Exporters"]
  node_otlp_trace["OTLP trace exporters"]
  node_otlp_metric["OTLP metric exporters"]
  node_otlp_log["OTLP log exporters"]
  node_prometheus["Prometheus exporter"]
  node_stdout["Stdout exporters"]
  node_zipkin["Zipkin exporter"]
end

subgraph group_compat["Compatibility Bridges"]
  node_opencensus["OpenCensus bridge"]
  node_opentracing["OpenTracing bridge"]
end

node_app(("Instrumented application"))
node_backend(("Observability platform"))

node_app -->|"instruments"| node_trace_api
node_app -->|"instruments"| node_metric_api
node_app -.->|"instruments"| node_log_api
node_trace_api -.->|"configures provider"| node_trace_sdk
node_metric_api -.->|"configures provider"| node_metric_sdk
node_log_api -.->|"configures provider"| node_log_sdk
node_trace_sdk -.->|"exports traces"| node_otlp_trace
node_trace_sdk -.->|"exports traces"| node_zipkin
node_trace_sdk -.->|"exports traces"| node_stdout
node_metric_sdk -.->|"exports metrics"| node_otlp_metric
node_metric_sdk -.->|"exports metrics"| node_prometheus
node_metric_sdk -.->|"exports metrics"| node_stdout
node_log_sdk -.->|"exports logs"| node_otlp_log
node_log_sdk -.->|"exports logs"| node_stdout
node_otlp_trace -->|"sends traces"| node_backend
node_otlp_metric -->|"sends metrics"| node_backend
node_otlp_log -->|"sends logs"| node_backend
node_prometheus -.->|"exposes metrics"| node_backend
node_zipkin -.->|"sends traces"| node_backend
node_metric_sdk -->|"uses resource"| node_resource
node_propagation -->|"reads context"| node_trace_api
node_semconv -->|"builds attributes"| node_attribute
node_opencensus -.->|"bridges API"| node_trace_api
node_opencensus -.->|"bridges API"| node_metric_api
node_opentracing -.->|"bridges API"| node_trace_api

click node_trace_api "https://github.com/open-telemetry/opentelemetry-go/blob/main/trace.go"
click node_metric_api "https://github.com/open-telemetry/opentelemetry-go/blob/main/metric.go"
click node_log_api "https://github.com/open-telemetry/opentelemetry-go/blob/main/log.go"
click node_trace_sdk "https://github.com/open-telemetry/opentelemetry-go/tree/main/sdk/trace"
click node_metric_sdk "https://github.com/open-telemetry/opentelemetry-go/blob/main/sdk/metric/pipeline.go"
click node_log_sdk "https://github.com/open-telemetry/opentelemetry-go/tree/main/sdk/log"
click node_resource "https://github.com/open-telemetry/opentelemetry-go/tree/main/sdk/resource"
click node_propagation "https://github.com/open-telemetry/opentelemetry-go/blob/main/propagation/trace_context.go"
click node_baggage "https://github.com/open-telemetry/opentelemetry-go/blob/main/baggage/context.go"
click node_semconv "https://github.com/open-telemetry/opentelemetry-go/tree/main/semconv"
click node_otlp_trace "https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/otlp/otlptrace"
click node_otlp_metric "https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/otlp/otlpmetric"
click node_otlp_log "https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/otlp/otlplog"
click node_prometheus "https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/prometheus"
click node_stdout "https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/stdout"
click node_zipkin "https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/zipkin"
click node_opencensus "https://github.com/open-telemetry/opentelemetry-go/tree/main/bridge/opencensus"
click node_opentracing "https://github.com/open-telemetry/opentelemetry-go/tree/main/bridge/opentracing"
click node_attribute "https://github.com/open-telemetry/opentelemetry-go/blob/main/attribute/value.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_trace_api,node_metric_api,node_log_api toneBlue
class node_trace_sdk,node_metric_sdk,node_log_sdk,node_resource toneAmber
class node_propagation,node_baggage,node_semconv,node_attribute toneMint
class node_otlp_trace,node_otlp_metric,node_otlp_log,node_prometheus,node_stdout,node_zipkin toneRose
class node_opencensus,node_opentracing,node_app,node_backend toneIndigo
```

## Components

### Telemetry APIs

- [Trace API](https://github.com/open-telemetry/opentelemetry-go/blob/main/trace.go): `trace.go`
- [Metric API](https://github.com/open-telemetry/opentelemetry-go/blob/main/metric.go): `metric.go`
- [Log API](https://github.com/open-telemetry/opentelemetry-go/blob/main/log.go): `log.go`

### SDK Processing

- [Trace SDK](https://github.com/open-telemetry/opentelemetry-go/tree/main/sdk/trace): `sdk/trace`
- [Metric SDK](https://github.com/open-telemetry/opentelemetry-go/blob/main/sdk/metric/pipeline.go): `sdk/metric/pipeline.go`
- [Log SDK](https://github.com/open-telemetry/opentelemetry-go/tree/main/sdk/log): `sdk/log`
- [Resource detection](https://github.com/open-telemetry/opentelemetry-go/tree/main/sdk/resource): `sdk/resource`

### Context and Conventions

- [Trace propagation](https://github.com/open-telemetry/opentelemetry-go/blob/main/propagation/trace_context.go): `propagation/trace_context.go`
- [Baggage context](https://github.com/open-telemetry/opentelemetry-go/blob/main/baggage/context.go): `baggage/context.go`
- [Semantic conventions](https://github.com/open-telemetry/opentelemetry-go/tree/main/semconv): `semconv`
- [Attribute types](https://github.com/open-telemetry/opentelemetry-go/blob/main/attribute/value.go): `attribute/value.go`

### Exporters

- [OTLP trace exporters](https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/otlp/otlptrace): `exporters/otlp/otlptrace`
- [OTLP metric exporters](https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/otlp/otlpmetric): `exporters/otlp/otlpmetric`
- [OTLP log exporters](https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/otlp/otlplog): `exporters/otlp/otlplog`
- [Prometheus exporter](https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/prometheus): `exporters/prometheus`
- [Stdout exporters](https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/stdout): `exporters/stdout`
- [Zipkin exporter](https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/zipkin): `exporters/zipkin`

### Compatibility Bridges

- [OpenCensus bridge](https://github.com/open-telemetry/opentelemetry-go/tree/main/bridge/opencensus): `bridge/opencensus`
- [OpenTracing bridge](https://github.com/open-telemetry/opentelemetry-go/tree/main/bridge/opentracing): `bridge/opentracing`

### Other components

- **Instrumented application**
- **Observability platform**

## Connections

- Instrumented application → Trace API: instruments
- Instrumented application → Metric API: instruments
- Instrumented application → Log API: instruments
- Trace API → Trace SDK: configures provider
- Metric API → Metric SDK: configures provider
- Log API → Log SDK: configures provider
- Trace SDK → OTLP trace exporters: exports traces
- Trace SDK → Zipkin exporter: exports traces
- Trace SDK → Stdout exporters: exports traces
- Metric SDK → OTLP metric exporters: exports metrics
- Metric SDK → Prometheus exporter: exports metrics
- Metric SDK → Stdout exporters: exports metrics
- Log SDK → OTLP log exporters: exports logs
- Log SDK → Stdout exporters: exports logs
- OTLP trace exporters → Observability platform: sends traces
- OTLP metric exporters → Observability platform: sends metrics
- OTLP log exporters → Observability platform: sends logs
- Prometheus exporter → Observability platform: exposes metrics
- Zipkin exporter → Observability platform: sends traces
- Metric SDK → Resource detection: uses resource (evidence: `sdk/metric/pipeline.go`)
- Trace propagation → Trace API: reads context (evidence: `propagation/trace_context.go`)
- Semantic conventions → Attribute types: builds attributes (evidence: `semconv/v1.24.0/attribute_group.go`)
- OpenCensus bridge → Trace API: bridges API
- OpenCensus bridge → Metric API: bridges API
- OpenTracing bridge → Trace API: bridges API
