OpenTelemetry 速查
共 25 条 OpenTelemetry 可观测性，涵盖核心概念、SDK 初始化、Collector、环境变量、后端与采样。 支持搜索与分类筛选，点击即可复制。
核心概念
统一 traces / metrics / logs 的采集标准。
| 命令 | 说明 |
|---|---|
| 一次调用链 / 链中一个操作 | |
| 指标 / 日志 | |
| 跨服务传递 trace 上下文（traceparent 头） | |
| 资源信息（服务名等）与键值属性 | |
| OpenTelemetry Protocol，标准上报协议 |
SDK 初始化
按语言引入 SDK 与导出器。
| 命令 | 说明 |
|---|---|
| 初始化链路导出 | |
| Node 自动埋点 | |
| Go 手动埋点 | |
| Java 零侵入（自动插桩） | |
| 创建 span 并自动结束 |
Collector
接收 → 处理 → 导出。
| 命令 | 说明 |
|---|---|
| 接收器（OTLP 端口 4317/4318） | |
| 处理器（批处理、限流、属性处理） | |
| 导出器（发往后端） | |
| 把三段串成管道 | |
| 运行 Collector（也可用容器镜像） |
环境变量
免改代码的配置方式。
| 命令 | 说明 |
|---|---|
| 服务名（出现在后端） | |
| 上报端点 | |
| 采样率控制 | |
| 自定义资源属性 | |
| 上报鉴权头 |
后端与采样
常见对接与采样策略。
| 命令 | 说明 |
|---|---|
| 链路存储与查询 | |
| 指标存储与看板 | |
| 日志存储 | |
| 采样位置不同，效果不同 | |
| 采样实践 |
使用说明
OpenTelemetry 速查：核心概念、SDK 初始化、Collector、环境变量、后端与采样；支持搜索与分类筛选，点击即可复制。
- 按用途点分类：核心概念、SDK 初始化、Collector、环境变量、后端与采样。
- 点「命令」列复制到代码或配置。
- 架构：应用 SDK → Collector → 后端（Jaeger/Tempo/Prometheus）。
- 先用环境变量（OTEL_SERVICE_NAME/OTLP_ENDPOINT）快速接入，再按需改代码。
常见问题
- 为什么用 Collector 而不直接发后端？
- Collector 集中做批处理、重试、脱敏、采样与多渠道导出，避免每个应用各自为政，也便于切换后端。
- 采样怎么选？
- 高流量服务先低比例 head sampling；要"保留所有错误与慢请求"则用 tail sampling（在 Collector 侧决策）。
- 需要联网吗？
- 速查内容本地可用；上报数据到后端需联网。