用途:为 Python API 提供结构化可观测性方案,使用 Logfire 快速接入,使用 OpenTelemetry 实现厂商中立的遥测导出。适用于追踪 API 请求与依赖、采集带上下文的结构化日志、将遥测导出到 OTLP 收集器。
主要能力:设置服务元数据(service_name、environment);对 FastAPI 与 httpx 自动埋点以生成请求 span;记录包含请求 ID 与用户上下文的结构化日志;通过采样降低高流量服务的遥测量;通过 OTLP 导出保持后端可替换。
使用方式:安装命令为 uv pip install logfire。快速开始中,先调用 logfire.configure(service_name="backend"),再调用 logfire.instrument_fastapi(app) 与 logfire.instrument_httpx()。OpenTelemetry 导出示例中,使用 Resource 设置 service.name,通过 TracerProvider 与 BatchSpanProcessor 配合 OTLPSpanExporter 导出 span。
限制与排错:缺少服务名会导致 span 在 UI 中难以查找;高基数属性会膨胀存储;埋点调用过晚会造成没有 span。参考资料为 Logfire 文档与 OpenTelemetry Python 埋点文档。其余细节暂未提供。