OpenTelemetry (OTEL)：云原生时代的可观测性标准与实战指南

组件名称	功能说明
API	定义遥测数据的采集接口（语言级 SDK）
SDK	提供默认实现，如采样器、处理器等
Instrumentation	自动或手动对代码打点，采集 Trace/Metrics
Exporter	将遥测数据导出到后端（如 Jaeger、Prometheus）
Collector	可选组件，用于集中接收和转发遥测数据

[应用代码]
   ↓ Instrumentation
[OTEL SDK 采集数据]
   ↓
[Exporter / Collector]
   ↓
[可观测性后端：Jaeger / Prometheus / Grafana 等]

三、支持的数据类型

类型	描述
Trace	记录系统中请求的流转过程，是分布式系统中最常见的诊断方式。
Metrics	收集系统运行时指标（如延迟、请求量、内存等），用于监控和告警。
Logs	提供请求上下文和事件信息，支持结构化日志格式，正逐步与 Trace 集成。

四、OpenTelemetry 如何收集数据？

OpenTelemetry 的数据采集机制基于 Instrumentation（插桩），分为自动插桩和手动插桩两种方式，配合 SDK 与导出器完成遥测数据采集与上报：

1. 自动插桩（Auto-Instrumentation）

无需改动业务逻辑，OpenTelemetry 能自动拦截常见框架调用。

✅ 示例：

Java 使用 opentelemetry-javaagent.jar 自动接入 Spring Boot、Tomcat、gRPC 等
Python 使用 CLI 工具一键插桩：

opentelemetry-instrument python app.py

支持框架：

Web 框架：Flask、Django、Spring Boot
数据库驱动：MySQL、PostgreSQL、MongoDB
消息系统：Kafka、RabbitMQ
HTTP/gRPC 调用等

2. 手动插桩（Manual Instrumentation）

在代码中手动创建 Span 或 Metric，适用于自定义业务逻辑或核心流程。

Java 示例：

Span span = tracer.spanBuilder("processOrder").startSpan();
try {
    // 业务逻辑
} finally {
    span.end();
}

Python 示例：

with tracer.start_as_current_span("query-db"):
    do_query()

3. SDK 内部采样与聚合

采样（Sampling）：决定是否记录该次调用（如 AlwaysOn、比例采样等）
聚合（Aggregation）：对 Metrics 进行统计、求和、计算直方图等
处理器（Processor）：支持批处理、队列缓存、动态导出控制

4. Exporter：导出遥测数据

OpenTelemetry 支持多种导出器：

类型	说明
Console Exporter	控制台打印数据，方便调试
Jaeger Exporter	向 Jaeger 导出分布式追踪数据
Prometheus Exporter	暴露 HTTP 接口供 Prometheus 抓取
OTLP Exporter	标准化格式，支持 Collector 等多个后端
Logging Exporter	输出为结构化日志格式

5. Collector：可选集中式接收与转发组件

OTEL Collector 是生产环境常用的组件，它支持：

接收 OTLP、Jaeger、Zipkin 协议的数据
对数据进行过滤、转换、聚合
将数据导出至多种后端（如 Jaeger、Prometheus、Loki）

[Service A] ─▶ OTLP ─▶ [OTEL Collector] ─▶ Jaeger
[Service B] ─▶ Metrics ─▶ Prometheus

五、生态与语言支持

OpenTelemetry 提供多语言 SDK，覆盖：

Java、Go、Python、JavaScript / Node.js、.NET、C++、Ruby 等
支持主流框架和平台，如 Spring Boot、Flask、Django、Kubernetes、Istio

其 Exporter 模块支持对接众多后端系统，如 Jaeger、Zipkin、Prometheus、Grafana、OTLP、Datadog、New Relic 等。

六、实战：在 Java 和 Python 中集成 OTEL

🟦 Java 集成示例（导出至 Jaeger）

Maven 依赖：

<dependencies>
  <dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-sdk</artifactId>
    <version>1.35.0</version>
  </dependency>
  <dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-exporter-jaeger</artifactId>
    <version>1.35.0</version>
  </dependency>
</dependencies>

代码实现：

import io.opentelemetry.api.GlobalOpenTelemetry;
import io.opentelemetry.api.trace.Span;
import io.opentelemetry.api.trace.Tracer;
import io.opentelemetry.exporter.jaeger.JaegerGrpcSpanExporter;
import io.opentelemetry.sdk.OpenTelemetrySdk;
import io.opentelemetry.sdk.trace.SdkTracerProvider;
import io.opentelemetry.sdk.trace.export.BatchSpanProcessor;

public class OtelJavaExample {
    public static void main(String[] args) {
        JaegerGrpcSpanExporter exporter = JaegerGrpcSpanExporter.builder()
            .setEndpoint("http://localhost:14250")
            .build();

        SdkTracerProvider tracerProvider = SdkTracerProvider.builder()
            .addSpanProcessor(BatchSpanProcessor.builder(exporter).build())
            .build();

        OpenTelemetrySdk openTelemetry = OpenTelemetrySdk.builder()
            .setTracerProvider(tracerProvider)
            .buildAndRegisterGlobal();

        Tracer tracer = GlobalOpenTelemetry.getTracer("demo-java");

        Span span = tracer.spanBuilder("demo-span").startSpan();
        try {
            System.out.println("Hello from OpenTelemetry Java");
        } finally {
            span.end();
            tracerProvider.close();
        }
    }
}

📍 可通过 Jaeger UI 查看效果：http://localhost:16686

🐍 Python 集成示例（控制台输出 / Jaeger）

安装依赖：

pip install opentelemetry-sdk opentelemetry-exporter-console

控制台导出示例：

from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import ConsoleSpanExporter, SimpleSpanProcessor

trace.set_tracer_provider(TracerProvider())
tracer = trace.get_tracer(__name__)

span_processor = SimpleSpanProcessor(ConsoleSpanExporter())
trace.get_tracer_provider().add_span_processor(span_processor)

with tracer.start_as_current_span("demo-python-span"):
    print("Hello from OpenTelemetry Python")

导出到 Jaeger：

pip install opentelemetry-exporter-jaeger

from opentelemetry.exporter.jaeger.thrift import JaegerExporter

jaeger_exporter = JaegerExporter(
    agent_host_name="localhost",
    agent_port=6831,
)

trace.get_tracer_provider().add_span_processor(
    SimpleSpanProcessor(jaeger_exporter)
)

七、Java vs Python 集成对比

特性	Java	Python
SDK 安装方式	Maven 依赖	pip 安装
Tracer 实例化	显式注册	动态绑定
默认导出支持	Jaeger、OTLP	Console、Jaeger
自动 Instrumentation	Spring、gRPC、Tomcat	Flask、Django、FastAPI 等