1. OTelMock 概述
1.1 什么是 OTelMock
OTelMock 是一个专为 OpenTelemetry 生态设计的轻量级模拟框架，用于在隔离环境中模拟遥测数据的生成、发送与接收。它允许开发者和测试工程师在不依赖真实后端（如 Jaeger、Prometheus、Grafana）的情况下，验证应用程序的埋点逻辑、数据格式与传输行为。
核心定位：OTelMock 不是数据采集器，也不是仪表盘工具，而是一个可编程的遥测数据模拟器，专注于测试与验证环节。
OTelMock 支持三种 OpenTelemetry 信号类型的模拟：
- Traces（链路） — 模拟 Span 创建、父子关系、属性与事件。
- Metrics（指标） — 模拟 Counter、Histogram、Gauge 等数据点。
- Logs（日志） — 模拟结构化日志记录与上下文关联。
1.2 OTelMock 在可观测性测试中的作用
在可观测性测试中，OTelMock 扮演着数据源模拟器与验证网关的双重角色。其核心作用可归纳为以下五个方面：
| 作用维度 | 具体说明 | 典型场景 |
|---|---|---|
| 1. 隔离外部依赖 | 测试时不连接真实后端，避免网络波动、认证失败、数据污染等问题。 | CI/CD 流水线中的自动化测试 |
| 2. 数据格式验证 | 检查应用发出的 OTLP 数据是否符合 OpenTelemetry 协议规范。 | SDK 升级后的回归测试 |
| 3. 埋点完整性检查 | 验证关键业务路径是否产生了预期的 Span、Metric 或 Log。 | 新功能上线前的埋点审计 |
| 4. 异常场景模拟 | 模拟数据丢失、延迟、格式错误等异常，测试应用的容错能力。 | 混沌工程与边界测试 |
| 5. 性能基线建立 | 在固定模拟负载下测量 SDK 的 CPU/内存开销，建立性能基线。 | SDK 性能调优与容量规划 |
实践建议：在微服务架构中，建议为每个服务单元编写独立的 OTelMock 测试，确保每个服务的遥测数据在隔离环境中通过验证后，再集成到全链路测试中。
1.3 与传统 Mock 工具的对比
传统 Mock 工具（如 Mockito、WireMock、MockServer）主要针对 HTTP/RPC 接口的模拟，而 OTelMock 专注于 OpenTelemetry 协议（OTLP）的模拟与验证。以下从多个维度进行对比：
| 对比维度 | 传统 Mock 工具 | OTelMock |
|---|---|---|
| 协议支持 | HTTP、gRPC、Thrift 等通用协议 | OTLP (gRPC + HTTP/protobuf) |
| 数据模型 | 请求/响应结构（JSON、XML） | Span、Metric、Log 的 OTel 数据模型 |
| 上下文关联 | 无内置关联能力 | 支持 TraceId/SpanId 关联、父子 Span 验证 |
| 时序语义 | 无时间序列概念 | 支持时间戳、Histogram 分桶、时间窗口聚合 |
| 断言能力 | 匹配请求路径、Header、Body 字段 | 按 Span 属性、Metric 值、Log 级别等结构化断言 |
| 典型用途 | API 集成测试、服务间契约测试 | 可观测性埋点测试、SDK 集成验证 |
1.4 何时选择 OTelMock
根据测试目标选择合适的工具，以下场景优先推荐使用 OTelMock：
- 埋点覆盖率测试 — 需要验证每个业务操作是否产生预期的遥测数据。
- SDK 版本升级验证 — 检查新版本 SDK 是否改变了数据格式或行为。
- 自定义 Exporter 测试 — 验证自定义 OTLP Exporter 的数据发送逻辑。
- 可观测性契约测试 — 在服务间约定遥测数据的结构与内容。
- 离线/本地开发 — 在无网络或无法连接后端的环境中进行开发调试。
注意：OTelMock 不适用于端到端全链路压测或生产环境监控。它专注于测试隔离与数据验证，而非性能压测或长期观测。