使用OTEL Java自动插装遇导出器连接错误，如何禁用导出器？

问题描述 #

使用Java OTEL Agent对Java服务插装时，出现如下连接失败警告：

[otel.javaagent 2024-01-10 03:02:35:052 +0000] [OkHttp http://localhost:4317/...] WARN io.opentelemetry.exporter.internal.grpc.GrpcExporter - Failed to export spans. Server responded with gRPC status code 2. Error message: Failed to connect to localhost/127.0.0.1:4317
[otel.javaagent 2024-01-10 03:02:55:054 +0000] [OkHttp http://localhost:4317/...]

尝试通过以下环境变量禁用导出器但未生效：

ENV OTEL_AGENT_OPTS="-javaagent:/opentelemetry-javaagent.jar -Dotel.resource.attributes=service.name=schema -Dlogging.level.io.opentelemetry.exporter.logging.*=OFF -Dotel.metrics.exporter=none -Dotel.spans.exporter=none -Dotel.instrumentation.grpc.enabled=false"

修复方案 #

1. 修正系统属性名称 #

你使用了错误的追踪导出器参数：OpenTelemetry Java Agent中，禁用追踪导出的正确参数是otel.traces.exporter=none，而非otel.spans.exporter=none。指标导出的参数otel.metrics.exporter=none是正确的。

修正后的OTEL_AGENT_OPTS应为：

ENV OTEL_AGENT_OPTS="-javaagent:/opentelemetry-javaagent.jar -Dotel.resource.attributes=service.name=schema -Dlogging.level.io.opentelemetry.exporter.logging.*=OFF -Dotel.metrics.exporter=none -Dotel.traces.exporter=none -Dotel.instrumentation.grpc.enabled=false"

2. 改用环境变量直接配置（更可靠） #

避免通过-D参数传递，直接使用OpenTelemetry标准环境变量，Agent会自动识别：

ENV OTEL_TRACES_EXPORTER=none
ENV OTEL_METRICS_EXPORTER=none
ENV OTEL_RESOURCE_ATTRIBUTES=service.name=schema
ENV OTEL_INSTRUMENTATION_GRPC_ENABLED=false

这种方式不需要在OTEL_AGENT_OPTS里嵌套-D参数，配置更清晰，也不容易出错。

3. 排查配置覆盖问题 #

检查应用目录下是否存在otel.properties或其他配置文件，这些文件中的设置可能会覆盖环境变量。确保文件内没有将otel.traces.exporter设为默认的otlp。

4. 升级Agent版本 #

部分旧版本的Java Agent可能仍使用otel.spans.exporter这类旧参数，建议升级到最新稳定版Agent，确保参数兼容最新规范。

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