ECS Fargate中Kinesis消费者无法在X-Ray中显示的排查求助

在ECS Fargate上运行Kinesis消费者，尝试接入AWS X-Ray做链路追踪，已经完成以下配置但X-Ray始终没有数据显示：

1. 在CloudFormation任务定义中添加了X-Ray sidecar容器，容器已正常运行：

{
  "name": "xray-daemon",
  "Image": "************.dkr.ecr.us-east-1.amazonaws.com/xray-daemon",
  "cpu": 32,
  "memoryReservation": 256,
  "portMappings": [
    {
      "containerPort": 2000,
      "protocol": "udp"
    }
  ]
}

2. 在SNS发布操作前后加了埋点代码：

AWSXRay.beginSubsegment("SNS Publish")
// 执行发布操作
AWSXRay.endSubsegment();

3. 应用启动时配置了全局Recorder：

AWSXRayRecorderBuilder builder = AWSXRayRecorderBuilder.standard().withPlugin(new ECSPlugin())
AWSXRay.setGlobalRecorder(builder.build())

消费者运行正常，但X-Ray里完全看不到相关追踪数据，请问可能遗漏了哪些配置？

• 检查任务执行角色权限：ECS任务的执行角色必须拥有xray:PutTraceSegments和xray:PutTelemetryRecords权限，X-Ray daemon依赖这两个权限把追踪数据上传到X-Ray服务，没权限的话数据根本传不上去。
• 确认应用与X-Ray Daemon的通信：应用默认往127.0.0.1:2000发UDP数据，Fargate用awsvpc网络模式时容器共享网络命名空间，理论上能直接访问，但要确认没在代码里手动改发送地址，同时检查任务网络配置有没有限制UDP通信。
• 必须初始化根Segment：只加Subsegment没用，所有Subsegment必须嵌套在根Segment里才能被上报。比如在Kinesis消息处理的入口处加AWSXRay.beginSegment("KinesisConsumerProcess")，处理完调用AWSXRay.endSegment()，把你的SNS Subsegment放在这个根Segment的生命周期里。
• 核对SDK版本兼容性：确保用的AWS X-Ray SDK版本和ECS Plugin兼容，版本不匹配可能导致追踪数据无法被正确处理和上报。
• 查看X-Ray Daemon日志：去CloudWatch Logs里看X-Ray daemon的日志，确认它有没有收到应用发的追踪数据，有没有上传失败的报错（比如权限不足、网络不通），这是快速定位问题的关键。
• 检查Fargate任务的X-Ray集成设置：虽然用了sidecar，还是要确认任务定义里的执行角色或任务角色是否关联了X-Ray权限，同时确保任务的日志配置能正常收集daemon的日志，方便排查。

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