本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS Step Functions and AWS X-Ray
<a name="xray-services-stepfunctions"></a>

AWS X-Ray 与集成 AWS Step Functions 以跟踪和分析 Step Functions 的请求。您可以可视化状态机的组件、确定性能瓶颈以及对导致错误的请求进行故障排除。有关更多信息，请参阅 AWS Step Functions 开发者指南中的[AWS X-Ray 和 Step F](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-xray-tracing.html) unctions。

**在创建新状态机时启用 X-Ray 跟踪**

1. 打开 Step Functions 控制台，网址为[https://console.aws.amazon.com/states/](https://console.aws.amazon.com/states/)。

1. 选择**创建状态机**。

1. 在**定义状态机**页面，选择**使用代码段创作**或**使用模板开始**。如果您选择运行示例项目，则无法在创建过程中启用 X-Ray 跟踪。相反，请在创建状态机之后启用 X-Ray 跟踪。

1. 选择**下一步**。

1. 在**指定详细信息**页面，配置状态机。

1. 选择 “**启用 X-Ray 跟踪**”。

**在现有状态机中启用 X-Ray 跟踪**

1. 在 Step Functions 控制台中，选择要为其启用跟踪的状态机。

1. 选择**编辑**。

1. 选择 “**启用 X-Ray 跟踪**”。

1. （可选）通过从 “ X-Ray 权限” 窗口中选择 “**创建新角色”，为状态机添加 Auto-generate 一个包含权限的新角色**。  
![权限部分包含创建新角色、选择现有角色或输入 ARN 的选项。](http://docs.aws.amazon.com/zh_cn/xray/latest/devguide/images/stepfunctions-permissions.png)

1. 选择**保存**。

**注意**  
当您创建新的状态机时，如果对请求进行了采样并在 Amazon API Gateway 或 AWS Lambda Amazon API Gateway 等上游服务中启用了跟踪，则会自动对其进行跟踪。对于任何未通过控制台（例如通过 CloudFormation 模板）配置的现有状态机，请检查您是否有授予足够权限以启用 X-Ray跟踪的 IAM 策略。