# OpenTelemetry 埋点升级验收工作流

盘点旧属性、迁移 OTel 语义约定、核对链路上下文传播，并用真实 trace 验收跨服务埋点。

> 标准页面: https://elysiatools.com/zh/hubs/opentelemetry-instrumentation-upgrade-verification

- **关键词:** OpenTelemetry 语义约定迁移, OTel 上下文传播验证, traceparent 校验, 埋点升级验收

## 常见问题

### 迁移工具会直接更新线上 Collector 吗？

不会。它输出改写草稿、改名映射和警告；需要审查后通过正常发布流程部署。

### traceparent 头部有效就能证明链路埋点正常吗？

不能。头部只说明格式与样本传播关系；还要看升级后导出的 trace 是否确实包含相连的 span 和预期服务。

### 一条 trace 能证明服务 P99 达标吗？

不能。单条 trace 有助于定位阶段耗时；百分位指标必须依据有代表性的观测窗口计算。

### 什么时候改用一般可观测性主题？

日志、Webhook、载荷等多类证据驱动的线上事故应使用 observability-debugging；本页针对计划中的埋点迁移验收。

## 相关内容

- [用日志、链路、Webhook 和 JSON 载荷做可观测性调试](https://elysiatools.com/zh/hubs/observability-debugging): 解析日志，解码调用链，检查 Webhook/API 证据，探索 JSON 载荷，并提取重复模式，形成可用于事故复盘的调试结论。
- [PII 检测与日志脱敏复核](https://elysiatools.com/zh/hubs/pii-log-redaction): 在日志、文本和 PDF 中发现疑似个人信息，生成脱敏候选稿，校验标识符模式，并在共享前要求人工审批。
- [API 请求格式检查、重放准备与调试工具](https://elysiatools.com/zh/hubs/api-request-replay-and-debugging): 检查请求结构，准备本地重放，对比响应并定位 API 调试线索。工具只做本地分析或生成，不能代替真实鉴权和服务端测试。