---
title: "OpenTelemetry (OTel)"
created: 2026-06-10
updated: 2026-06-10
type: concept
tags: [observability, standards, tracing, open-telemetry]
sources: [raw/articles/pydantic-three-piece-suite-2026.md]
---

# OpenTelemetry (OTel)

> CNCF 孵化的可观测性标准，定义了一套统一的 tracing、metrics、logging 数据格式和传输协议。

## 核心价值

- **厂商中立**：数据格式开放，不锁定任何后端
- **标准语义**：定义 `gen_ai.operation.name`、`gen_ai.usage.input_tokens` 等标准字段，框架层自动遵守
- **多后端分发**：同一份数据可同时发送到 Grafana、Jaeger、[[logfire|Logfire]] 等

## 在 Pydantic 生态中的应用

[[logfire|Logfire]] 基于 OTel 标准构建，因此：
- trace 数据可导出到任何 OTel 兼容后端
- 可通过 OpenTelemetry Collector 做数据清洗/采样
- 即使 Logfire 公司不存在了，trace 数据格式仍然可读

## 典型架构

```
你的代码 → OTLP → Collector（清洗/采样）→ Logfire / Grafana / Jaeger
```

## 参考

- [[logfire|Logfire]]
- [[agent-observability|Agent 可观测性]]
- [[drift-detection|漂移检测]]
