기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

AWS X-Ray은 AWS Step Functions와 통합되어 Step Function에 대한 요청을 추적하고 분석합니다. 상태 시스템 구성 요소를 시각화하고 성능 병목 현상을 식별하며 오류가 발생한 요청 문제를 해결할 수 있습니다. 자세한 내용은 AWS Step Functions 개발자 안내서의 [AWS X-Ray 및 Step Functions](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-xray-tracing.html)를 참조하세요.

**새로운 상태 시스템을 생성할 때 X-Ray 트레이싱을 활성화하기**

1. [https://console.aws.amazon.com/states/](https://console.aws.amazon.com/states/)에서 Step Functions 콘솔을 엽니다.

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.aws.amazon.com/ko_kr/xray/latest/devguide/images/stepfunctions-permissions.png)

1. **저장**을 선택합니다.

**참고**  
새 상태 시스템을 생성할 때 요청이 샘플링되고 Amazon API Gateway 또는 AWS Lambda과 같은 업스트림 서비스에서 추적이 활성화되면 자동으로 추적됩니다. 콘솔을 통해 구성되지 않은 기존 상태 머신(예: CloudFormation 템플릿)의 경우, X-Ray 추적을 활성화할 수 있는 충분한 권한을 부여하는 IAM 정책이 있는지 확인하세요.