AWS Support에 대한 Amazon S3 요청 ID 가져오기 - Amazon Simple Storage Service
HTTP를 이용한 요청 ID 가져오기웹 브라우저를 이용한 요청 ID 가져오기AWS SDK를 이용한 요청 ID 가져오기AWS CLI을 이용한 요청 ID 가져오기Windows PowerShell을 사용하여 요청 ID 가져오기AWS CloudTrail 데이터 이벤트를 이용한 요청 ID 가져오기S3 서버 액세스 로깅을 이용한 요청 ID 가져오기

AWS Support에 대한 Amazon S3 요청 ID 가져오기

Amazon S3에서 오류나 예기치 않은 동작이 발생하여 AWS Support에 문의할 때는 실패한 작업과 관련된 요청 ID를 제공해야 합니다. AWS Support이 요청 ID를 사용하여 해당 문제의 해결을 지원합니다.

요청 ID는 쌍으로 되어 있고 Amazon S3에서 처리하는 모든 응답(잘못된 응답이라도)에 반환되며 상세 정보 로그를 통해 액세스할 수 있습니다. 요청 ID를 가져오는 데는 S3 액세스 로그 및 AWS CloudTrail 이벤트 또는 데이터 이벤트 등의 여러 가지 일반적인 방법을 사용할 수 있습니다.

이 로그를 복구한 후에는 에 문의할 때 필요하므로 두 값을 복사하여 보관하세요AWS Support AWS Support에 문의하는 방법에 대한 자세한 내용은 AWS 문의 또는 AWS Support 설명서를 참조하세요.

HTTP를 이용한 요청 ID 가져오기

HTTP 요청이 대상 애플리케이션에 도달하기 전에 이 요청을 기록하여 요청 ID x-amz-request-id 및 x-amz-id-2를 가져올 수 있습니다. HTTP 요청의 상세 정보 로그를 복구할 수 있는 다양한 타사 도구가 있습니다. 신뢰할 수 있는 도구를 하나 선택하여 다른 Amazon S3 HTTP 요청을 보낼 때 Amazon S3 트래픽이 통과하는 포트에서 수신 대기할 도구를 실행합니다.

HTTP 요청의 경우 요청 ID 쌍은 다음과 같이 표시됩니다.

x-amz-request-id: 79104EXAMPLEB723 
x-amz-id-2: IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km
참고

HTTPS 요청은 암호화되어 대부분의 패킷 캡처에서 숨겨집니다.

웹 브라우저를 이용한 요청 ID 가져오기

대부분의 웹 브라우저에는 요청 헤더를 보는 데 사용할 수 있는 개발자 도구가 있습니다.

오류를 반환하는 웹 브라우저 기반 요청의 경우 요청 ID 쌍이 다음 예와 같이 표시됩니다.

<Error><Code>AccessDenied</Code><Message>Access Denied</Message>
<RequestId>79104EXAMPLEB723</RequestId><HostId>IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km</HostId></Error>

성공적인 요청에서 요청 ID 쌍을 가져오려면 브라우저의 개발자 도구를 사용하여 HTTP 응답 헤더를 확인합니다. 특정 브라우저의 개발자 도구에 대한 자세한 내용은 AWS re:Post의 Amazon S3 문제 해결 - S3 요청 ID 복구 방법을 참조하세요.

AWS SDK를 이용한 요청 ID 가져오기

다음 섹션에는 AWS SDK를 사용한 로깅 구성에 대한 정보가 있습니다. 모든 요청과 응답에서 상세 정보 로깅을 활성화할 수 있지만 대량 요청 또는 응답은 애플리케이션 속도를 크게 떨어뜨릴 수 있으므로 프로덕션 시스템에서는 로깅을 활성화하지 않는 것이 좋습니다.

AWS SDK 요청의 경우 요청 ID 페어는 다음 예와 같이 표시됩니다.

Status Code: 403, AWS Service: Amazon S3, AWS Request ID: 79104EXAMPLEB723  
AWS Error Code: AccessDenied  AWS Error Message: Access Denied  
S3 Extended Request ID: IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km

SDK for Go를 이용한 요청 ID 가져오기

SDK for Go를 사용하여 로깅을 구성할 수 있습니다. 자세한 내용은 SDK for Go V2 개발자 안내서의 응답 메타데이터를 참조하세요.

SDK for PHP를 이용한 요청 ID 가져오기

PHP를 사용하여 로깅을 구성할 수 있습니다. 자세한 내용은 AWS SDK for PHP 개발자 안내서의 네트워크를 통해 전송되는 데이터를 확인하려면 어떻게 해야 하나요?를 참조하세요.

SDK for Java를 이용한 요청 ID 가져오기

특정 요청이나 응답에 로깅을 활성화하여 관련 헤더만 포착하고 반환할 수 있습니다. 그러려면 com.amazonaws.services.s3.S3ResponseMetadata 클래스를 가져오십시오. 그런 다음 실제 요청을 수행하기 전에 변수에 요청을 저장할 수 있습니다. 로깅된 요청이나 응답을 가져오려면 getCachedResponseMetadata(AmazonWebServiceRequest request).getRequestID()를 호출합니다.

PutObjectRequest req = new PutObjectRequest(bucketName, key, createSampleFile());
s3.putObject(req);
S3ResponseMetadata md = s3.getCachedResponseMetadata(req);
System.out.println("Host ID: " + md.getHostId() + " RequestID: " + md.getRequestId());

그 대신 모든 Java 요청 및 응답의 상세 정보 로깅을 사용할 수 있습니다. 자세한 내용은 AWS SDK for Java 개발자 안내서의 상세 유선 로깅을 참조하세요.

AWS SDK for .NET을 이용한 요청 ID 가져오기

기본 제공된 System.Diagnostics 로깅 도구를 사용하여 AWS SDK for .NET으로 로깅을 구성할 수 있습니다. 자세한 내용은 AWS SDK for .NET으로 로깅 AWS 개발자 블로그 게시물을 참조하세요.

참고

반환되는 정보에는 기본적으로 오류 정보만 포함됩니다. 요청 ID를 가져오려면 구성 파일에 AWSLogMetrics(및 선택적으로 AWSResponseLogging)가 추가되어 있어야 합니다.

SDK for Python(Boto3)을 이용한 요청 ID 가져오기

AWS SDK for Python (Boto3)을 사용하여 특정 응답을 로깅할 수 있습니다. 이 기능을 사용하여 관련 헤더만 캡처할 수 있습니다. 다음 코드에서는 응답의 일부를 파일에 로깅하는 방법을 보여줍니다.

import logging
import boto3
logging.basicConfig(filename='logfile.txt', level=logging.INFO)
logger = logging.getLogger(__name__)
s3 = boto3.resource('s3')
response = s3.Bucket(bucket_name).Object(object_key).put()
logger.info("HTTPStatusCode: %s", response['ResponseMetadata']['HTTPStatusCode'])
logger.info("RequestId: %s", response['ResponseMetadata']['RequestId'])
logger.info("HostId: %s", response['ResponseMetadata']['HostId'])
logger.info("Date: %s", response['ResponseMetadata']['HTTPHeaders']['date'])

예외가 발생할 때 예외를 확인하고 관련 정보를 기록할 수도 있습니다. 자세한 내용은 AWS SDK for Python(Boto) API 참조의 오류 응답에서 유용한 정보 식별을 참조하세요.

또한 다음 코드를 사용하여 자세한 디버깅 로그를 출력하도록 Boto3를 구성할 수 있습니다.

import boto3
boto3.set_stream_logger('', logging.DEBUG)

자세한 내용은 AWS SDK for Python(Boto) API 참조의 set_stream_logger 섹션을 참조하세요.

SDK for Ruby를 이용한 요청 ID 가져오기

SDK for Ruby 버전 1, 2 또는 3을 사용하여 요청 ID를 가져올 수 있습니다.

  • Ruby용 SDK - 버전 1 사용 - 다음 코드 줄을 사용하여 HTTP 유선 로깅을 전역적으로 사용 설정할 수 있습니다.

    s3 = AWS::S3.new(:logger => Logger.new($stdout), :http_wire_trace => true)

  • Ruby용 SDK - 버전 2 또는 버전 3 사용 - 다음 코드 줄을 사용하여 HTTP 유선 로깅을 전역적으로 사용 설정할 수 있습니다.

    s3 = Aws::S3::Client.new(:logger => Logger.new($stdout), :http_wire_trace => true)

AWS 클라이언트에서 유선 정보를 가져오는 팁은 디버깅 팁: 클라이언트에서 유선 추적 정보 가져오기를 참조하세요.

AWS CLI을 이용한 요청 ID 가져오기

AWS Command Line Interface(AWS CLI)를 사용할 때 요청 ID를 가져오려면 명령에 --debug를 추가하세요.

Windows PowerShell을 사용하여 요청 ID 가져오기

Windows PowerShell을 사용한 로그 복구에 대한 자세한 내용은 AWS Tools for Windows PowerShell에서 응답 로깅 .NET 개발 블로그 게시물을 참조하세요.

AWS CloudTrail 데이터 이벤트를 이용한 요청 ID 가져오기

S3 객체 수준 API 작업을 로깅하도록 CloudTrail 데이터 이벤트를 사용하여 구성된 Amazon S3 버킷은 Amazon S3의 사용자, 역할 또는 AWS 서비스가 수행한 작업의 세부 정보를 제공합니다. Athena를 사용하여 CloudTrail 이벤트를 쿼리함으로써 S3 요청 ID를 식별할 수 있습니다.

S3 서버 액세스 로깅을 이용한 요청 ID 가져오기

S3 서버 액세스 로깅에 대해 구성된 Amazon S3 버킷은 버킷에 수행된 각 요청에 대한 상세 레코드를 제공합니다. Athena를 사용하여 서버 액세스 로그를 쿼리함으로써 S3 요청 ID를 식별할 수 있습니다.