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

# Amazon Step Functions 和 Amazon X-Ray
Step Functions

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

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

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

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

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

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

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

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

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

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

1. 选择**编辑**。

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

1. （可选）从“权限”窗口选择**创建新角色**，为状态机自动生成新角色以包含 X-Ray 权限。  
![\[Permissions section with options to create a new role, choose existing, or enter ARN.\]](http://docs.amazonaws.cn/xray/latest/devguide/images/stepfunctions-permissions.png)

1. 选择**保存**。

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