S3 Vectors용 AWS CloudTrail을 사용하여 로깅 - Amazon Simple Storage Service
CloudTrail의 S3 Vectors 정보S3 Vectors에 대한 CloudTrail 관리 이벤트S3 Vectors에 대한 CloudTrail 데이터 이벤트S3 Vectors에 대한 데이터 이벤트 로깅 활성화

S3 Vectors용 AWS CloudTrail을 사용하여 로깅

참고

Amazon S3 Vectors는 Amazon Simple Storage Service의 미리 보기 릴리스이며 변경될 수 있습니다.

Amazon S3 Vectors는 사용자, 역할, 또는 AWS 서비스가 수행한 작업에 대한 레코드를 제공하는 서비스인 AWS CloudTrail과 통합됩니다. CloudTrail은 S3 Vectors에 대한 모든 API 직접 호출을 이벤트로 캡처합니다. CloudTrail에서 수집한 정보를 사용하여 S3 Vectors에 전송된 요청, 요청이 이루어진 IP 주소, 요청이 이루어진 시간, 추가 세부 정보를 확인할 수 있습니다. 지원되는 이벤트 활동이 S3 Vectors에서 발생하면 해당 활동이 CloudTrail 이벤트에 기록됩니다. CloudTrail 추적을 사용하여 S3 Vectors에 대한 관리 이벤트 및 데이터 이벤트를 로깅할 수 있습니다.

CloudTrail에 대한 자세한 내용은 CloudTrail 사용 설명서를 참조하세요.

CloudTrail의 S3 Vectors 정보

CloudTrail은 계정 생성 시 AWS 계정에서 활성화됩니다. S3 Vectors에서 활동이 발생하면 해당 활동이 이벤트 기록의 다른 AWS 서비스 이벤트와 함께 CloudTrail 이벤트에 기록됩니다. AWS 계정에서 최신 이벤트를 확인, 검색 및 다운로드할 수 있습니다. 자세한 설명은 CloudTrail 이벤트 기록으로 이벤트 보기를 참조하세요.

S3 Vectors에 대한 이벤트를 포함하여 AWS 계정에 이벤트를 지속적으로 기록하려면 추적을 생성합니다. CloudTrail은 추적을 사용하여 Amazon S3 버킷으로 로그 파일을 전송할 수 있습니다. 콘솔에서 추적을 생성하면 기본적으로 모든 AWS 지역에 추적이 적용됩니다. 추적은 AWS 파티션에 있는 모든 지역의 이벤트를 로깅하고 지정된 Amazon S3 버킷으로 로그 파일을 전송합니다. 또한 CloudTrail 로그에서 수집된 이벤트 데이터를 추가 분석 및 작업하도록 다른 AWS 서비스를 구성할 수 있습니다. 자세한 내용은 CloudTrail 사용 설명서의 Overview for Creating a Trail, Configuring Amazon SNS Notifications for CloudTrail, Receiving CloudTrail Log Files from Multiple Regions 및 Receiving CloudTrail Log Files from Multiple Accounts를 참조하세요.

모든 S3 Vectors API 작업은 CloudTrail에서 로깅되며 Amazon S3 Vectors API 참조에 설명되어 있습니다. 예를 들어 CreateVectorBucket, CreateIndex 및 QueryVectors 작업에 대한 직접 호출에서는 CloudTrail 로그 파일에 항목이 생성됩니다.

모든 이벤트 또는 로그 항목에는 요청을 생성했던 사용자에 대한 정보가 포함됩니다. ID 정보를 이용하면 다음을 쉽게 판단할 수 있습니다.

  • 요청을 루트로 했는지 아니면 IAM 사용자 보안 인증 정보로 했는지 여부.

  • 역할 또는 페더레이션 사용자의 임시 보안 인증을 사용하여 요청이 생성되었는지 여부.

  • 다른 AWS 서비스에서 요청했는지.

자세한 내용은 CloudTrail 사용 설명서의 CloudTrail userIdentity 요소를 참조하세요.

S3 Vectors에 대한 CloudTrail 관리 이벤트

관리 이벤트는 AWS 계정의 리소스에 대해 수행되는 관리 작업에 대한 정보를 제공합니다. 이를 컨트롤 플레인 작업이라고도 합니다. 기본적으로 CloudTrail은 관리 이벤트를 로깅합니다.

S3 Vectors의 경우 CloudTrail은 다음 관리 이벤트를 로깅합니다.

S3 Vectors 관리 이벤트 및 데이터 이벤트에 대한 eventSource는 s3vectors.amazonaws.com입니다.

관리 이벤트에 대한 자세한 내용은 CloudTrail 사용 설명서의 Logging management events를 참조하세요.

S3 Vectors에 대한 CloudTrail 데이터 이벤트

데이터 이벤트는 리소스 상에서, 또는 리소스 내에서 수행되는 리소스 작업에 대한 정보를 제공합니다. 이를 데이터 영역 작업이라고도 합니다. 기본적으로 CloudTrail은 데이터 이벤트를 로깅하지 않습니다. 그러나 S3 Vectors 리소스에 대한 데이터 이벤트를 로깅하도록 추적을 구성할 수 있습니다.

데이터 이벤트를 로깅하도록 추적을 구성할 때 S3 Vectors 리소스 유형을 지정할 수 있습니다. S3 Vectors는 데이터 이벤트에 대해 다음과 같은 리소스 유형을 지원합니다.

  • AWS::S3Vectors::VectorBucket - 지정된 벡터 버킷의 모든 벡터 인덱스에 대한 데이터 이벤트를 로깅합니다.

  • AWS::S3Vectors::Index - 특정 벡터 인덱스에 대한 데이터 이벤트를 로깅합니다.

S3 Vectors의 경우 CloudTrail은 다음 데이터 이벤트를 로깅합니다.

벡터 데이터 작업:

  • PutVectors - 벡터가 벡터 인덱스에 추가될 때 로깅합니다.

  • GetVectors - 벡터 인덱스에서 벡터를 검색할 때 로깅합니다.

  • DeleteVectors - 벡터 인덱스에서 벡터가 삭제될 때 로깅됩니다.

  • ListVectors - 벡터 인덱스의 벡터가 나열될 때 로깅됩니다.

  • QueryVectors - 벡터 인덱스에서 유사성 쿼리가 수행될 때 로깅됩니다.

S3 Vectors 데이터 이벤트에 대한 eventSource는 s3vectors.amazonaws.com입니다.

S3 Vectors에 대한 데이터 이벤트 로깅 활성화

CloudTrail 추적을 만들거나 업데이트할 때 S3 Vectors 리소스에 대한 데이터 이벤트 로깅을 활성화할 수 있습니다. 계정의 모든 벡터 버킷 및 벡터 인덱스에 대한 로깅을 지정하거나 개별 벡터 버킷 또는 벡터 인덱스를 지정할 수 있습니다. 추적 만들기에 대한 자세한 단계는 CloudTrail 사용 설명서의 Creating a trail을 참조하세요.

모든 S3 Vectors 리소스에 대해 데이터 이벤트 로깅 활성화

  • 추적을 만들거나 업데이트할 때 데이터 이벤트를 선택합니다.

  • 리소스 유형에서 AWS::S3Vectors::VectorBucket을 선택합니다.

  • 리소스 ARN에 arn:aws:s3vectors:_:_:bucket/*을 입력하여 모든 벡터 버킷에 대한 이벤트를 로깅하거나 개별 벡터 버킷 ARN(예: arn:aws:s3vectors:us-east-1:123456789012:bucket/amzn-s3-demo-vector-bucket)을 지정합니다.

특정 벡터 인덱스에 대한 데이터 이벤트 로깅 활성화

  • 추적을 만들거나 업데이트할 때 데이터 이벤트를 선택합니다.

  • 리소스 유형에서 AWS::S3Vectors::Index을 선택합니다.

  • 리소스 ARN에 arn:aws:s3vectors:us-east-1:123456789012:bucket/amzn-s3-demo-vector-bucket/index/my-index 등 특정 벡터 인덱스의 ARN을 입력합니다.

데이터 이벤트에 대한 자세한 내용은 CloudTrail 사용 설명서의 Logging data events를 참조하세요.

주제