OpenTelemetry Agent 1.15出现AsynchronousMetricStorage告警问题咨询

集成OpenTelemetry Java Agent 1.15版本的Spring应用运行时，PeriodicMetricReader-1线程会输出如下WARN级别日志：

[otel.javaagent 2022-06-22 14:45:13:965 +0530] [PeriodicMetricReader-1] WARN io.opentelemetry.sdk.metrics.internal.state.AsynchronousMetricStorage - Instrument db.client.connections.idle.min has recorded multiple values for the same attributes.
[otel.javaagent 2022-06-22 14:45:13:972 +0530] [PeriodicMetricReader-1] WARN io.opentelemetry.sdk.metrics.internal.state.AsynchronousMetricStorage - Instrument db.client.connections.max has recorded multiple values for the same attributes.
[otel.javaagent 2022-06-22 14:45:13:976 +0530] [PeriodicMetricReader-1] WARN io.opentelemetry.sdk.metrics.internal.state.AsynchronousMetricStorage - Instrument db.client.connections.pending_requests has recorded multiple values for the same attributes.

日志核心含义为：db.client.connections.idle.min、db.client.connections.max、db.client.connections.pending_requests三个数据库连接相关的异步指标，在单次采集周期内针对同一组属性标签记录了多个值。

• 该问题是OpenTelemetry Java Agent 1.15.x版本的已知实现缺陷，出在JDBC连接池指标的埋点逻辑上。
• OpenTelemetry异步指标（Asynchronous Instrument）的语义约束为：单个采集周期内，同一组属性标签组合只能上报1个指标值。1.15版本Agent采集数据库连接池指标时，若应用内存在多个数据源/连接池实例，埋点逻辑不会自动为不同实例补充唯一区分维度（如连接池名称、数据源标识），导致多个连接池的同名指标被打上完全相同的标签，采集时就会对同一标签组重复写入值，触发该告警。
• 告警触发时，SDK默认仅保留第一次写入的指标值，后续重复值会被直接丢弃，不会造成应用运行异常、内存泄漏类问题，但会导致对应数据库连接指标数据失真，无法区分不同数据源的连接状态。

• 首选修复方案：直接将OpenTelemetry Java Agent升级到1.16.0及以上版本。官方在1.16版本修复了JDBC连接池指标的埋点逻辑，会自动为不同数据源、连接池实例补充唯一区分维度，从根源避免同标签重复写入的问题。
• 若暂时无法升级Agent，可选择以下临时规避方案：
  • 检查应用内所有数据源配置，为每个数据源实例设置唯一的连接池名称标识，Agent生成指标时会自动携带该名称作为区分标签，避免标签重复。
  • 若不需要采集数据库连接池相关指标，可在应用启动参数中添加配置-Dotel.instrumentation.common.db-metrics.enabled=false，直接关闭内置的通用数据库连接池指标采集。
  • 若仅需要屏蔽告警日志、不关心指标准确性，可调整日志配置，将io.opentelemetry.sdk.metrics.internal.state.AsynchronousMetricStorage类的日志级别设置为ERROR，过滤掉该类WARN日志。

内容的提问来源于stack exchange，提问作者Valsaraj Viswanathan