通过Otel-Collector向HoneyComb导出Span遇FRAME_SIZE_ERROR问题

一、指标导出UNIMPLEMENTED错误 #

原因 #

OpenTelemetry Java SDK默认会自动尝试导出Metrics数据，但你的Otel-Collector配置里只配置了traces管道，没有处理Metrics的管道，导致Collector返回UNIMPLEMENTED错误。

解决办法 #

选其中一种即可：

1. Java端禁用Metrics导出（推荐，因为你只需要导出Trace）：
   在构建OpenTelemetrySdk时，显式设置空的MeterProvider，或者通过JVM参数禁用：

   • 代码修改示例：

     SdkMeterProvider sdkMeterProvider = SdkMeterProvider.builder().build();
     openTelemetry = OpenTelemetrySdk.builder()
             .setTracerProvider(sdkTracerProvider)
             .setMeterProvider(sdkMeterProvider)
             .buildAndRegisterGlobal();
     

   • 或启动Java应用时添加JVM参数：-Dotel.metrics.exporter=none

2. Collector添加Metrics管道（如果需要收集指标）：
   在Collector配置的service.pipelines节点下添加：

   metrics:
     receivers: [otlp]
     processors: [batch]
     exporters: [logging] # 可替换为你需要的指标导出器，比如Prometheus
   

二、Span导出FRAME_SIZE_ERROR错误 #

原因 #

该错误由多个因素共同导致：

1. Java端用OtlpGrpcSpanExporter连接localhost:4318，但4318是OTLP HTTP端口，gRPC协议对应的端口是4317，而docker-compose里将4317映射为4343，导致请求发错端口。
2. 默认gRPC最大帧大小约4MB，你的Span数据（比如包含大属性、日志）超过了这个限制。
3. Collector导出到Honeycomb的配置有误：配置2中otlp导出器用了http://api.honeycomb.io:443，应该使用HTTPS协议并开启TLS。

解决办法 #

1. 修正Java端的Collector连接配置

选以下两种方式之一：

• 改用OTLP HTTP Exporter（更稳定，规避gRPC帧大小限制问题）：

  OtlpHttpSpanExporter otlpHttpSpanExporter = OtlpHttpSpanExporter.builder()
          .setEndpoint("http://localhost:4318/v1/traces")
          .build();
  

• 修正gRPC Exporter端点并调整帧大小：

  OtlpGrpcSpanExporter otlpGrpcSpanExporter = OtlpGrpcSpanExporter.builder()
          .setEndpoint("http://localhost:4343") // 对应docker映射的4343->4317端口
          .setChannelBuilder(NettyChannelBuilder.forTarget("localhost:4343")
                  .maxInboundMessageSize(10 * 1024 * 1024) // 调整最大帧大小为10MB
                  .usePlaintext())
          .build();
  

2. 修正Collector的Honeycomb导出配置

推荐使用otlphttp导出器（Honeycomb官方推荐），配置示例：

exporters:
  otlphttp:
    endpoint: "https://api.honeycomb.io/v1/traces"
    headers:
      "x-honeycomb-team": "YOUR_API_KEY"
      "x-honeycomb-dataset": "YOUR_DATASET"

如果坚持用otlp导出器，需开启TLS：

exporters:
  otlp:
    endpoint: "api.honeycomb.io:443"
    headers:
      "x-honeycomb-team": "YOUR_API_KEY"
      "x-honeycomb-dataset": "YOUR_DATASET"
    tls:
      insecure: false

3. 调整Collector的gRPC接收大小

在Collector的otlp receiver的grpc配置中增加最大消息大小：

receivers:
  otlp:
    protocols:
      grpc:
        max_recv_msg_size_mib: 10 # 根据你的数据大小调整，示例为10MB
      http:

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