Amazon S3 및 AWS X-Ray

AWS X-Ray는 Amazon S3와 통합되어 업스트림 요청을 추적하여 애플리케이션의 S3 버킷을 업데이트합니다. 서비스가 X-Ray SDK를 사용하여 요청을 추적하는 경우, Amazon S3는 추적 헤더를 AWS Lambda, Amazon SQS, Amazon SNS와 같은 다운스트림 이벤트 구독자에게 보낼 수 있습니다. X-Ray는 Amazon S3 이벤트 알림에 대한 추적 메시지를 활성화합니다.

X-Ray 트레이스 맵을 사용하여 Amazon S3와 애플리케이션에서 사용하는 다른 서비스의 연결을 확인할 수 있습니다. 또한 콘솔을 사용하여 평균 대기 시간 및 실패율과 같은 메트릭을 볼 수 있습니다. X-Ray 콘솔 사용 방법에 대한 자세한 내용은 X-Ray 콘솔 사용하기 섹션을 참조하십시오.

Amazon S3는 기본 http 헤더 계측을 지원합니다. AWS SDK를 통해 Amazon S3를 직접 호출하면 X-Ray SDK는 자동으로 추적 헤더를 HTTP 헤더로 채웁니다. 기본 추적 헤더는 X-Amzn-Trace-Id로 전달됩니다. 추적 헤더에 대한 자세한 내용은 개념 페이지의 추적 헤더를 참조하십시오. Amazon S3 추적 컨텍스트 전파는 다음 구독자를 지원합니다: Lambda, SQS 및 SNS. SQS와 SNS는 세그먼트 데이터를 자체적으로 전송하지 않기 때문에 트레이스 헤더를 다운스트림 서비스에 전파하더라도 S3에 의해 트리거될 때 트레이스 또는 트레이스 맵에 나타나지 않습니다.

Amazon S3 이벤트 알림 구성

Amazon S3 알림 기능을 사용하면 버킷에서 특정 이벤트가 발생하면 알림을 받을 수 있습니다. 이러한 알림은 애플리케이션 내에서 다음 대상에 전파할 수 있습니다:

지원되는 이벤트 목록은 Amazon S3 개발자 가이드에서 지원되는 이벤트 유형을 참조하세요.

Amazon SNS 및 Amazon SQS

SNS 주제 또는 SQS 대기열에 알림을 게시하려면 먼저 Amazon S3 권한을 부여해야 합니다. 이러한 권한을 부여하려면 대상 SNS 주제 또는 SQS 대기열에 AWS Identity and Access Management (IAM) 정책을 연결합니다. 필요한 IAM 정책에 대해 자세히 알아보려면 SNS 주제 또는 SQS 대기열에 메시지를 게시할 권한 부여 섹션을 참조하십시오.

SNS와 SQS를 X-Ray와 통합하는 방법에 대한 자세한 내용은 Amazon SNS 및 AWS X-Ray 및 Amazon SQS 및 AWS X-Ray을 참조하십시오.

AWS Lambda

Amazon S3 콘솔을 사용하여 S3 버킷에 Lambda 함수용 이벤트 알림을 구성할 때 이 콘솔은 버킷에서 함수를 간접 호출하기 위한 권한을 Amazon S3에 부여하도록 Lambda 함수에 필수 권한을 설정합니다. 자세한 내용은 Amazon Simple Storage Service 콘솔 사용 설명서의 S3 버킷에 대한 이벤트 알림을 활성화하고 구성하려면 어떻게 해야 하나요?를 참조하세요.

또한, AWS Lambda에서 Lambda 함수를 호출할 수 있는 권한을 Amazon S3에 부여할 수도 있습니다. 자세한 내용은 AWS Lambda 개발자 안내서의 자습서: Amazon S3을 AWS Lambda와 함께 사용을 참조하세요.

Lambda와 X-Ray를 통합하는 방법에 대한 자세한 내용은 AWS Lambda에서의 자바 코드 계측을 참조하십시오.