Docker专用网络中Python客户端容器无法向Jaeger容器发送OTLP数据

核心现象回顾 #

• 三个容器（客户端C、SQL Server S、Jaeger J）处于同一Docker专用网络，C与S通信正常；宿主机可向J推送指标，但C向J发送OTLP数据时超时
• C能telnet通J的tcp/4317端口，但无法发送OTLP数据
• 容器内部解析主机名时会指向DigitalOcean的可路由IP段，宿主机及Windows物理机无此问题
• 错误信息：

向172.19.0.3:4317导出追踪数据时遇到临时错误StatusCode.DEADLINE_EXCEEDED，将在1秒后重试。

排查与解决步骤 #

1. 验证Jaeger的OTLP接收器配置

OTLP over gRPC和普通TCP连接逻辑不同，需确保Jaeger容器启动时已启用OTLP接收器。检查Jaeger的启动命令，确认包含以下参数：

--collector.otlp.enabled=true

若未配置该参数，Jaeger仅会监听4317端口但不处理OTLP gRPC请求，这会导致telnet能连通，但实际OTLP数据无法被接收。

2. 确认客户端的目标地址配置

虽然你采用了IP地址方案，但需排查客户端代码/配置中是否实际使用了主机名而非IP：

• 若客户端配置的是Jaeger的主机名，容器内部错误解析到DigitalOcean的IP，会导致数据发往错误地址，最终触发超时
• 强制客户端配置为J容器的实际IP（172.19.0.3:4317），直接排除解析异常的影响

3. 检查Docker网络的流量规则

即使处于同一专用网络，Docker的iptables规则或容器自身的防火墙可能拦截gRPC流量：

• 查看Jaeger容器的iptables规则，确认允许4317端口的gRPC（HTTP/2）流量通行
• 检查Docker daemon的网络配置，确保专用网络未启用额外的隔离规则

4. 调整客户端的OTLP超时配置

DEADLINE_EXCEEDED错误可能源于客户端设置的超时时间过短：

• 查看客户端的OTLP exporter配置，将超时时间延长至10秒以上（例如调整gRPC客户端的grpc.max_send_message_length及超时参数）
• 避免因网络延迟导致的过早超时判定

5. 检查Jaeger容器的资源状态

若Jaeger容器CPU、内存资源不足，无法及时处理请求也会引发超时：

• 使用docker stats查看Jaeger容器的资源占用情况
• 查看Jaeger容器日志（docker logs <jaeger-container-id>），排查是否有资源耗尽或处理异常的报错

6. 统一网络MTU值

VirtualBox虚拟机与Docker容器的MTU不一致可能导致数据包分片失败：

• 查看宿主机（VirtualBox虚拟机）的MTU值：ip link show
• 修改Docker daemon的MTU配置（/etc/docker/daemon.json），设置与宿主机一致的MTU：

  {
    "mtu": 1500
  }
  

• 重启Docker daemon后重新启动所有容器

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