Scala项目中OpenTelemetry结合Mesmer无追踪数据导出问题求助

1. 确认依赖版本兼容性 #

• 检查Mesmer与OpenTelemetry Java Agent的版本匹配：Mesmer官方文档会指定兼容的OTel Agent版本范围，比如Scala 2.13对应的Mesmer版本是否要求OTel Agent 1.20+，避免版本不匹配导致扩展加载失败。
• 确保所有Mesmer扩展模块都已引入：针对你的技术栈，添加对应依赖：

  libraryDependencies ++= Seq(
    "io.kamon" %% "mesmer-play-extension" % "<mesmer-version>",
    "io.kamon" %% "mesmer-akka-extension" % "<mesmer-version>",
    "io.kamon" %% "mesmer-zio-extension" % "<mesmer-version>",
    "io.kamon" %% "mesmer-grpc-extension" % "<mesmer-version>"
  )
  

2. 检查JVM启动参数 #

OTel Agent和Mesmer扩展必须通过JVM参数加载，确认sbt的javaOptions配置正确：

javaOptions ++= Seq(
  s"-javaagent:${new File((dependencyClasspath in Runtime).value.find(_.data.getName.startsWith("opentelemetry-javaagent")).get.data.getAbsolutePath)}",
  s"-Dotel.javaagent.extensions=${new File((dependencyClasspath in Runtime).value.find(_.data.getName.startsWith("mesmer-otel-extension")).get.data.getAbsolutePath)}",
  // 核心配置，必须设置服务名
  "-Dotel.service.name=your-service-name",
  // 强制采样，避免默认采样策略导致无数据
  "-Dotel.traces.sampler=always_on",
  // 开启OTel debug日志
  "-Dotel.logging.level=debug"
)

注意：不要硬编码agent路径，用sbt的dependencyClasspath自动获取，避免路径错误。

3. 验证Agent与扩展加载状态 #

启动项目后，在日志中查找以下关键信息：

• OpenTelemetry Java Agent initialized.：确认OTel Agent加载成功
• Loaded extension: io.kamon.mesmer.extension.MesmerExtension：确认Mesmer扩展加载成功
  如果没有这些日志，说明Agent或扩展未正确加载，检查JVM参数是否生效，或依赖是否正确引入。

4. 排查导出器配置 #

针对你尝试的导出器，确保配置完全正确：

Logging导出器 #

javaOptions += "-Dotel.traces.exporter=logging"

启动后查看日志，是否有SpanExporter输出的Span信息。

Zipkin导出器 #

javaOptions ++= Seq(
  "-Dotel.traces.exporter=zipkin",
  "-Dotel.exporter.zipkin.endpoint=http://localhost:9411/api/v2/spans"
)

确认Zipkin服务正常运行，端口匹配。

OTLP/Jaeger导出器 #

javaOptions ++= Seq(
  "-Dotel.traces.exporter=otlp",
  "-Dotel.exporter.otlp.endpoint=http://localhost:4317",
  "-Dotel.exporter.otlp.protocol=grpc"
)

确认Jaeger Collector在监听4317端口，无网络拦截。

5. 手动测试Span导出 #

如果自动 instrumentation无数据，手动创建Span验证OTel基础功能：

import io.opentelemetry.api.GlobalOpenTelemetry
import io.opentelemetry.api.trace.Tracer

// 在某个请求处理或初始化代码中添加
val tracer: Tracer = GlobalOpenTelemetry.getTracer("manual-test")
val span = tracer.spanBuilder("manual-test-span").startSpan()
try {
  Thread.sleep(200)
} finally {
  span.end()
}

如果手动Span能导出，说明Mesmer的自动 instrumentation存在问题；如果手动也无数据，排查OTel基础配置。

6. ZIO与Akka上下文绑定检查 #

• ZIO纤维模型需要OTel上下文与纤维上下文绑定，确认mesmer-zio-extension已引入，且ZIO应用中正确集成了Mesmer的追踪组件。
• Akka的Actor系统是否被Mesmer正确拦截：检查日志中是否有Akka instrumentation enabled相关信息。

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