使用 OpenTelemetry 构建可观测性 03 - 导出

原创

已于 2023-08-21 17:30:56 修改 · 1.6k 阅读

CC 4.0 BY-SA版权

文章标签：

于 2023-08-17 19:36:57 首次发布

本文详细介绍了如何使用OpenTelemetry的SDK进行遥测数据收集，包括创建TracerProvider、配置资源、使用链路追踪和选择导出器，以及Python示例。着重展示了如何将数据路由、添加元数据并发送至目标接收器如OTLPCollector。

上一个博文中，我提到如何使用 OpenTelemery 的特定语言 API 来收集遥测数据，包含手动和自动的埋点技术，这很重要！但是，收集遥测数据只是解决方案的第一步。

你需要把遥测数据路由转发到其他地方，同时添加额外的元数据信息。这时就轮到 SDK 发挥作用了。

链路追踪生产者是 SDK 中一个关键概念。用于将通过 API 收集的遥测数据与其他组件联系起来。在 Go 语言中，TracerProvider 对象只有一个 Tracer 方法的接口，方法签名如下：

Tracer(instrumentationName string, opts ...TracerOption) Tracer

Tracer 方法返回一个实现 Tracer 接口的对象，这个接口也只有一个方法 Start,其方法签名如下：

Start(ctx context.Context, spanName string, opts ...spanStartOption) (context.Context, Span)

样例项目中通过链路追踪生产者创建了跨度( span ):

import "go.opentelemetry.io/otel"

// ...

ctx, span := otel.Tracer(telemetry.TelemetryLibrary).Start(ctx, "get_product_price")

可以发现通过otel.Tracer 查找并创建全局的链路追踪生产者最终返回 Tracer 对象，需要注意要使用链路追踪生产者，其初始化设置是不可缺少的。

Note: 在文中提及是获取‘全局’链路追踪生产者的方法。使用全局链路追踪最简单的一种方式就是调用 otel.Tracer 的 API 。不过实际使用中如果上面方案不满足，还可以通过链路追踪生产者传递给消费者以替代全局查找的方法。

Note： trace 代表整个请求的路径信息、span 代表链路中的具体节点信息

链路追踪生产者还需要配置‘资源’对象，它是元数据信息的一部分。资源是遥测数据产生描述过程或者服务的信息，描述了服务本身的元数据，有助于解析遥测数据。

这是样例项目中