用途：为 Python 应用提供生产级 OpenTelemetry（OTEL）日志方案，让日志与追踪、指标通过 trace ID 关联，便于调试与监控。
主要能力：配置 OTEL 日志 Provider 与处理器；通过 LoggingInstrumentor 将追踪上下文自动注入日志；集成 structlog 做结构化日志；支持控制台、OTLP、Jaeger、文件等导出器；在 span 中记录异常；提供单元与集成测试写法；给出降低日志开销的优化建议。
使用方式：应用启动时只需初始化一次，例如调用 initialize_otel_logger(log_level="INFO", enable_console=True, enable_otlp=True, otlp_endpoint="localhost:4317")；各模块通过 logger、get_tracer 获取实例；用 trace_span("process_order", order_id="12345") 包裹操作，span 内日志自动带 trace_id 与 span_id。也可分别配置：用 LoggerProvider 与 ConsoleLogExporter（开发）或 OTLP 导出器（生产）搭建日志，用 structlog.configure 设置 merge_contextvars、TimeStamper、ExceptionRenderer、JSONRenderer 等处理器，并以 contextvars 保存 request_id、user_id 等请求级信息。
依赖与限制：需 opentelemetry-api/sdk、opentelemetry-exporter-otlp、opentelemetry-instrumentation-logging、structlog、pydantic，Python 3.11+。OTLP 连接失败需确认 Collector 与 4317 端口；日志无 trace ID 时确认先调用 LoggingInstrumentor().instrument() 且日志在 span 内产生；高开销时改用 BatchLogRecordExporter 并过滤 DEBUG。文中未提供具体价格与平台支持等细节。