CloudTrail을 사용하여 IDE 또는 CLI에서 제공하는 Amazon Q Developer 이벤트를 로깅하려면 어떻게 해야 합니까?

간략한 설명

IDE 또는 CLI에서 제공하는 이벤트는 CloudTrail 데이터 이벤트입니다. 기본적으로 CloudTrail은 데이터 이벤트를 로깅하지 않으므로 CloudTrail 이벤트 기록에서 이벤트를 볼 수 없습니다. IDE 또는 CLI가 CloudTrail에서 제공하는 Amazon Q Developer 이벤트를 로깅하려면 데이터 이벤트를 로깅하는 사용자 지정 추적을 생성하십시오.

참고: 다음 해결 방법을 사용하려면 Amazon Q Developer Pro 구독이 있어야 합니다. AWS 계정이 아닌 AWS Builder ID로 인증하기 때문에 프리 티어를 사용하여 CloudTrail에서 이벤트를 로깅할 수 없습니다.

해결 방법

Amazon Q Developer 데이터 이벤트에 대한 추적을 생성하려면 다음 단계를 완료하십시오.

1. CloudTrail 콘솔을 엽니다.
2. 탐색 창에서 추적을 선택합니다.
3. 추적 생성을 선택합니다.
4. 다음 추적 속성을 입력합니다.
   추적 이름
   로그를 저장할 Amazon Simple Storage Service(Amazon S3) 버킷
   (선택 사항) 고객 관리형 AWS Key Management Service(AWS KMS) 키
   참고: 모든 AWS Organizations 계정에 대한 추적을 생성하려면 조직 추적을 활성화하십시오. 올바른 권한이 있는 사용자 또는 역할로 관리 또는 위임된 관리자 계정에 로그인해야 합니다.
5. 다음을 선택합니다.
6. 로그 이벤트 선택 페이지에서 데이터 이벤트를 선택합니다.
7. CodeWhisperer를 선택합니다.
8. 추적 생성을 선택합니다.

CloudTrail 콘솔의 추적 페이지에서 새 추적을 볼 수 있습니다. 5분 후 CloudTrail은 계정의 AWS API 호출을 보여주는 로그 파일을 게시합니다. 지정된 S3 버킷의 로그 파일을 볼 수 있습니다.

또한 로그 파일을 Amazon CloudWatch Logs로 전송하도록 CloudTrail을 구성할 수 있습니다.

IDE에서 제공하는 이벤트에는 userIdentity 및 userAgent에 대한 세부 정보가 포함됩니다.

IDE 이벤트 예시:

"userIdentity": {
            "type": "IdentityCenterUser",
            "accountId": "111122223333",
            "onBehalfOf": {
                "userId": "123456789-123456789-123456789-123456789-123456789",
                "identityStoreArn": "arn:aws:identitystore::111122223333:identitystore/d-123456789"
            }
        },
"userAgent": "aws-sdk-js/0.0.1 ua/2.0 os/win32# lang/js md/nodejs#18.15.0 api/codewhispererstreaming#0.0.1 AmazonQ-For-VSCode/1.23.0",

CLI에서 제공하는 이벤트에는 userAgent 및 userContext에 대한 세부 정보가 포함됩니다.

CLI 이벤트 예시:

"userAgent": "aws-sdk-rust/1.3.3 api/codewhispererruntime/0.1.1100 os/macos lang/rust/1.80.1 app/AmazonQ-For-CLI",
"userContext": {
    "ideCategory": "CLI",
    "operatingSystem": "MAC",
    "product": "CodeWhisperer",
    "ideVersion": "1.3.0"
}

참고: CloudTrail에는 인라인 또는 채팅 프롬프트 세부 정보가 숨겨져 있습니다. 프롬프트 세부 정보를 캡처하려면 Amazon Q Developer 콘솔을 사용하여 프롬프트 로깅 기능을 활성화하십시오.

관련 정보

Amazon CodeWhisperer용 사용자 활동 대시보드 만들기

Amazon Q Developer의 원격 측정 이벤트 살펴보기

Amazon Q Developer에서 사용자 활동 보고서 활성화