# Observability 手册
`rs-zero` 的 `observability` feature 提供指标和 tracing 相关能力。
## 核心能力
- Prometheus 文本指标导出。
- REST metrics middleware。
- OpenTelemetry tracing 配置入口。
- OTLP trace endpoint、headers、resource attributes、sampling、timeout 和 shutdown/flush handle。
## 使用建议
- 所有服务都应启用 request-id，便于日志和 trace 串联。
- 默认测试不连接真实 collector；真实 OTLP collector 测试使用 ignored/external 路径。
- 初始化 tracing 时要避免重复安装 subscriber。
## 相关文档与测试
- [Observability](../observability.md)
- `examples/observability-hello/README.md`
- `examples/production-adapters/otlp-tracing.rs`
- `cargo test --test observability_integration`
- `cargo test --test observability_otlp`