F#中使用OpenTelemetry：Trace无法发送至Docker Collector求助

以下是针对性的排查步骤和解决方案：

1. 修正OTLP Exporter的协议与端点配置 #

.NET的AddOtlpExporter默认使用gRPC协议，但你代码中直接指定http://localhost:4317可能导致协议适配问题，需显式配置协议：

方案1：使用gRPC协议（推荐） #

修改F#代码中的Exporter配置，明确指定gRPC协议：

.AddOtlpExporter( fun opt ->
    opt.Endpoint <- Uri "http://localhost:4317"
    opt.Protocol <- OtlpExportProtocol.Grpc
)

方案2：切换到HTTP协议 #

若偏好HTTP协议，需先更新Collector启动命令添加端口映射，再调整代码：

• 启动Collector时新增端口映射：

  docker run -p 4317:4317 -p 4318:4318 -v /path/to/yaml/file:/etc/otel-collector-config.yaml otel/opentelemetry-collector:latest --config=/etc/otel-collector-config.yaml
  

• 代码中修改端点和协议：

  .AddOtlpExporter( fun opt ->
      opt.Endpoint <- Uri "http://localhost:4318/v1/traces"
      opt.Protocol <- OtlpExportProtocol.HttpProtobuf
  )
  

2. 解决Docker网络访问问题 #

若应用与Docker容器不在同一网络上下文，localhost可能无法正确指向宿主机：

• 若在WSL2中运行F#应用，需将localhost替换为Windows宿主IP（可通过cat /etc/resolv.conf获取nameserver对应的IP）；
• 若在Linux环境，确认防火墙未拦截4317/4318端口，且Docker端口映射规则生效；
• Windows宿主环境下，Docker Desktop的端口映射默认支持localhost访问，无需额外调整。

3. 避免程序提前退出导致数据未导出 #

你的应用启动Activity后立即退出，Batch处理器可能还未完成数据发送。可添加延迟或显式释放资源：

// 在main函数末尾添加
System.Threading.Thread.Sleep(2000) // 等待2秒确保导出完成
tracerProvider.Dispose() // 显式释放TracerProvider，触发数据导出

4. 检查Collector日志定位问题 #

利用Collector的debug日志排查是否收到请求：

docker logs <容器ID或名称>

• 若日志无OTLP接收记录：重点排查客户端配置或网络连通性；
• 若有错误日志：根据错误信息调整（如协议不匹配、权限问题等）。

5. 验证Collector端点可达性 #

用curl测试HTTP端点是否连通：

curl http://localhost:4318/v1/traces -v

返回405 Method Not Allowed说明端口正常（仅需POST请求）；若连接失败，需检查端口映射或网络。

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