Jaeger引入了对OpenTelemetry的原生支持

CNCF

发布于 2022-06-10 14:27:41

1.5K0

发布于 2022-06-10 14:27:41

文章被收录于专栏：CNCFCNCF

作者：Yuri Shkuro

最新的Jaeger v1.35 版本[1]引入了通过OpenTelemetry 协议（OTLP）[2]接收 OpenTelemetry 追踪数据的能力，所有 OpenTelemetry SDK 都需要支持该协议。这是之前宣布淘汰 Jaeger“经典”客户端库[3]的后续。

有了这项新功能，不再需要将 Jaeger 导出器与 OpenTelemetry SDK 一起使用，也不再需要在 Jaeger 后端运行 OpenTelemetry 收集器。使用 OTLP 导出器，SDK 可以配置为将数据直接发送到 Jaeger 后端。OTLP 接收器通过 gRPC 或 HTTP 端点接受数据。

Primer

让我们来看看这个功能的运行情况。首先，按照入门文档[4]中的说明启动 Jaeger 一体机：

docker run --name jaeger \
  -e COLLECTOR_OTLP_ENABLED=true \
  -p 16686:16686 \
  -p 4317:4317 \
  -p 4318:4318 \
  jaegertracing/all-in-one:1.35

请注意，与以前的版本相比：

导出列表中还添加了两个端口，4317 和 4318，OTLP 接收器使用它们来监听 gRPC 和 HTTP 连接。
OTLP 接收器必须通过 COLLECTOR_OTLP_ENABLED=true 使能。
我们删除了与本例无关的其他端口。

当 Jaeger 后端启动时，你应该会看到这两行日志：

{... "msg":"Starting GRPC server on endpoint 0.0.0.0:4317"}
{... "msg":"Starting HTTP server on endpoint 0.0.0.0:4318"}

和往常一样，Jaeger UI 可以在http://localhost:16686/访问。

现在让我们使用一个简单的 Python 程序，它用 OTLPSpanExporter 配置 OpenTelemetry SDK 并生成一个单跨度追踪。

from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter

trace.set_tracer_provider(TracerProvider())
trace.get_tracer_provider().add_span_processor(
    BatchSpanProcessor(OTLPSpanExporter())
)
tracer = trace.get_tracer(__name__)
with tracer.start_as_current_span("foo"):
    print("Hello world!")

basic_trace.py

opentelemetry-api
opentelemetry-sdk
opentelemetry-exporter-otlp-proto-http

requirements.txt

按如下方式运行该程序：

pip install -r requirements.txt
OTEL_SERVICE_NAME=primer python3 basic_trace.py

如果我们现在刷新 Jaeger UI 中的搜索屏幕，服务下拉列表应该包含服务 primer（请注意，我们通过环境变量将此服务名称传递给 SDK），来自此服务的追踪应该如下所示：

通过 OTLP 提交的样本追踪。

OTLP 接收器可以通过以--collector.otlp.*开头的多个标志进一步定制，这些标志可以通过收集器和 all-in-one 二进制文件中的 help 命令获得。这些标志允许更改两个 OTLP 服务器的端口号，配置 TLS，以及更改一些其他参数，如最大消息大小和保持活动状态。

限制

现有的实现有一些注意事项：

如果你的应用程序使用 OTLP 导出追踪和指标，那么你仍然需要运行 OpenTelemetry 收集器，因为 Jaeger 收集器只能接受 OTLP 数据的追踪部分。或者，你可以用指向不同后端的两个 OTLP 导出器来配置 SDK。
Jaeger 后端并不支持 OpenTelemetry 收集器中 OTLP 接收器支持的所有选项。
只有 Jaeger 收集器支持新的 OTLP 接收器。Jaeger 代理仅支持“经典”Jaeger 格式。如果你的部署需要本地代理，我们建议运行 OpenTelemetry 收集器。