首页/云/可观测性速查/Python SDK 初始化示例

Python SDK 初始化示例

Python 手动接入:创建 Resource 与 TracerProvider、挂批处理导出器、注册全局 provider,之后即可用 tracer 埋点。

可观测性速查云更新于 2026-10-12

初始化与埋点

初始化与埋点
from opentelemetry import trace
from opentelemetry.sdk.resources import Resource
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter

resource = Resource.create({"service.name": "checkout-api"})
provider = TracerProvider(resource=resource)
provider.add_span_processor(
    BatchSpanProcessor(OTLPSpanExporter(endpoint="http://otel-collector:4317", insecure=True)))
trace.set_tracer_provider(provider)

tracer = trace.get_tracer("checkout")
生产用 BatchSpanProcessor 批量发送;调试期可临时加 ConsoleSpanExporter 打印导出内容。

易错点

  • 忘了 set_tracer_provider 时埋点落到默认实现,数据静默丢弃
  • OTLP gRPC 端点不带协议前缀或端口写错会连接失败,先 curl 探活再排代码

数据来源与参考

  • OpenTelemetry Python · Getting started
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌