OpenTelemetry Java SDK 不支持直接读取同步计数器（LongCounter）的当前值，因其设计遵循“仅上报、不暴露状态”原则；推荐方案是使用带回调的异步计数器（buildWithCallback），由应用自行维护数值并在回调中提供。
opentelemetry java sdk 不支持直接读取同步计数器（longcounter）的当前值，因其设计遵循“仅上报、不暴露状态”原则；推荐方案是使用带回调的异步计数器（buildwithcallback），由应用自行维护数值并在回调中提供。
在 OpenTelemetry 的指标模型中，Counter 是一种单调递增的同步仪器（synchronous instrument），其核心语义是记录增量（如 add(1)），而非暴露内部状态。因此，LongCounter 接口不提供 getValue() 或类似方法——这并非功能缺失，而是有意为之的设计选择：它避免了竞态、简化了并发语义，并确保指标导出行为与观测系统（如 Prometheus、OTLP 后端）保持一致。
若业务逻辑确需实时访问计数值（例如用于健康检查、限流判断或调试），正确做法是将状态管理权交还应用层，并借助异步仪器实现桥接：
✅ 推荐方案：使用 LongCounterBuilder.buildWithCallback
通过 buildWithCallback 注册一个 LongConsumer 回调，OpenTelemetry 会在每次指标采集周期（scrape）触发该回调，由你传入当前维护的数值：
import io.opentelemetry.api.metrics.GlobalMeterProvider;
import io.opentelemetry.api.metrics.LongCounter;
import java.util.concurrent.atomic.AtomicLong;
// 1. 应用层自行维护计数值（线程安全）
private final AtomicLong appCounter = new AtomicLong(0);
// 2. 创建异步计数器：每次采集时回调提供当前值
LongCounter asyncCounter = GlobalMeterProvider
.get("my-instrumentation")
.counterBuilder("app.request.total")
.setDescription("Total number of processed requests")
.setUnit("1")
.buildWithCallback(result -> {
// 在此返回当前值（非增量！）
result.record(appCounter.get());
});
// 3. 应用代码中仍可正常「逻辑递增」
public void onRequestProcessed() {
long newValue = appCounter.incrementAndGet();
// 注意：此处不调用 asyncCounter.record() —— 它由回调自动完成
}⚠️ 关键注意事项：
立即学习“Java免费学习笔记（深入）”；
buildWithCallback创建的是 asynchronous counter（异步计数器），其行为与LongCounter.record(value)有本质区别：它上报的是快照值（value），而非增量（delta）。因此，在 Prometheus 等后端中，它将被识别为Gauge类型（可增可减），而非Counter（仅增）。若必须保持 Counter 语义（如兼容 Prometheus 的rate()计算），则不应强行读取值，而应重构逻辑依赖增量上报。- 回调函数应在毫秒级内完成，避免阻塞采集线程；禁止在回调中执行 I/O、锁竞争或复杂计算。
- 若需同时支持增量操作与值查询，建议封装为自定义计数器类，统一管理
AtomicLong和LongCounter实例。
❌ 不推荐的替代方案
- 尝试反射访问 SDK 内部状态（如
DefaultLongCounter）：不可靠、版本敏感、违反 API 稳定性承诺； - 轮询 exporter 缓存（如
InMemoryMetricReader）：延迟高、非实时、非线程安全，且不属于可观测性正向路径； - 混淆
UpDownCounter与Counter：UpDownCounter支持负增量，但仍不提供get()方法，且语义不同（适用于可增可减场景，如活跃连接数）。
总之，OpenTelemetry 的哲学是「观测即导出，状态归应用」。当你的场景需要读取当前值时，请拥抱异步模式，主动管理状态，并让 OpenTelemetry 专注做好采集与导出——这才是符合规范、可长期演进的实践方式。
