如何通过X-Ray在Splunk APM中追踪AWS Step Functions

Splunk Observability Suite（APM）无法直接使用AWS一键配置X-Ray采集到的Step Functions透传上下文数据。
核心原因有两点：

• AWS一键开启的Step Functions X-Ray追踪，输出的是X-Ray私有格式的Segment数据，跨Lambda透传的上下文依赖AWS自定义的X-Amzn-Trace-Id头，而Splunk APM默认采用OpenTelemetry生态的W3C Trace Context作为标准传播协议，原生不识别X-Ray私有格式的链路元数据
• 直接接入的话，Splunk APM最多只能采集到关联Lambda单独上报的零散调用片段，无法识别Step Functions状态机的节点拓扑、步骤跳转逻辑、执行状态等核心链路信息，会出现明显的链路断档，达不到全链路可观测的效果

• 方案1：OpenTelemetry Collector转译X-Ray数据（改造量最小）
  在AWS环境内部署带AWS X-Ray Receiver的OpenTelemetry Collector，给Collector配置对应IAM权限拉取Step Functions、关联Lambda上报的所有X-Ray链路数据，在Collector侧完成格式转换：把X-Ray的Trace ID、Span属性、错误标识映射为Splunk APM兼容的OTel标准格式，同时配置X-Amzn-Trace-Id和W3C Trace Context的双向关联规则，转换完成后直接将数据上报到Splunk APM接入点。这个方案不需要改动现有已经开启的X-Ray一键配置，改造量最小，转译完成后可以在Splunk服务地图里看到完整的Step Functions工作流拓扑、每个步骤的耗时、错误，以及关联Lambda和下游服务的完整调用链。
• 方案2：统一替换为OpenTelemetry原生埋点（链路质量最高）
  关闭默认的X-Ray一键追踪，给Step Functions开启原生OpenTelemetry追踪输出，给所有关联Lambda绑定Splunk适配的OTel Lambda层，全局统一配置W3C Trace Context作为传播协议，所有链路数据直接通过OTel Exporter上报到Splunk APM。这个方案不需要做格式转译，链路数据的字段一致性最高，还支持自定义注入业务标签，适合对链路追踪精度要求高、可以接受少量配置改动的场景。
• 方案3：日志事件关联拼接（零代码改造）
  开启Splunk AWS基础设施集成，配置采集Step Functions的CloudWatch执行日志、EventBridge状态变更事件，通过提取日志里的X-Amzn-Trace-Id和Lambda已经上报到Splunk APM的Trace数据做自动关联。这个方案完全不需要改动现有AWS侧的X-Ray配置，但是链路拼接的精度低于前两种方案，极端场景下会出现节点关联失败的问题，适合临时过渡使用。

实操提醒：如果选用方案1做转译，记得在Collector的转换规则里单独配置Step Functions专属字段的映射，比如状态机执行ARN、步骤名称、重试次数、错误类型这些字段，否则Splunk APM无法正确将对应节点识别为Step Functions服务，会把节点归到未知自定义服务分类里。

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