遥测与追踪
选择 OpenTelemetry Starter 或 Java Agent 模式。
master · 1.0.0-SNAPSHOT / 2026-10-29 核对
当前模块状态
nextrix-telemetry 聚合实现模块，groupId 为 io.nextrix.telemetry。OpenTelemetry 实现和 Java Agent 扩展参与默认构建；Micrometer 保留迁移前状态，不参与默认构建。
选择一种接入模式
Starter 模式由官方 OpenTelemetry Spring Boot Starter 管理 SDK 与自动配置，并通过 Spring AOP 支持 @WithSpan。Agent 模式使用官方 Java Agent 与 Nextrix 扩展。两种模式不能在同一应用中同时启用，以避免重复 SDK、Span 与指标。
application.yaml
nextrix:
telemetry:
enabled: true
metrics:
enabled: true
tracing:
enabled: true
otel:
metrics:
exporter: otlp
traces:
exporter: otlp源码节选 / 请结合完整示例与环境配置阅读
信号开关与导出
Starter 使用 nextrix.telemetry 下的总开关、metrics 与 tracing 信号开关，以及具体组件开关。SDK 采样、传播与导出仍使用 otel.*。Agent 扩展则使用 otel.instrumentation.nextrix*，不受 Spring 配置开关控制。
两种接入模式互斥。不要在同一应用中同时启用 Starter 与 Java Agent。
源码出处
本页依据下列源码或模块文档整理。访问需具备仓库权限。
nextrix-j/nextrix-telemetry/README.md