Amazon Q Developer에서 사용자의 프롬프트 로깅 - Amazon Q Developer

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

Amazon Q Developer에서 사용자의 프롬프트 로깅

관리자는 사용자가 통합 개발 환경(IDE)에서 Amazon Q와 나눈 모든 인라인 제안 및 채팅 대화의 로깅을 활성화할 수 있습니다. 이러한 로그는 감사, 디버깅, 분석 및 규정 준수 보장에 도움이 될 수 있습니다.

개발자가 인라인 제안을 사용하면 Amazon Q는 수락된 제안과 적극적으로 거부된 제안을 기록합니다. 개발자가 Amazon Q와 채팅할 때 Amazon Q는 개발자의 프롬프트와 Amazon Q의 응답을 모두 기록합니다. 개발자가 /dev 명령을 사용하여 소프트웨어 개발을 위한 Amazon Q 에이전트와 채팅하는 경우 해당 프롬프트만 로깅됩니다.

Amazon Q는 생성한 Amazon S3 버킷에 로그를 다음 경로에 저장합니다.

bucketName/prefix/AWSLogs/accountId/QDeveloperLogs/log-type/region/year/month/day/utc-hour/zipFile.gz/logFile.json

이전 경로에서 log-type는 다음 중 하나입니다.

  • GenerateAssistantResponse - 채팅 로그 보관

  • GenerateCompletions - 인라인 완료 로그 보유

  • StartTaskAssistCodeGeneration - /dev 로그 보관

로그 파일 콘텐츠의 예제와 설명은 섹션을 참조하세요Amazon Q Developer의 프롬프트 로그 예제.

로그를 보관하는 데 사용되는 Amazon S3 버킷의 스토리지 비용과 버킷을 암호화하는 데 사용되는 선택적 KMS 키에 대한 소액의 요금 외에는 프롬프트 로깅 기능에 대한 요금이 없습니다.

다음 지침에 따라 프롬프트 로깅을 활성화합니다.

사전 조건

Amazon S3 버킷을 생성하여 프롬프트 로그를 보관합니다. 버킷은 다음과 같아야 합니다.

  • Amazon Q Developer 프로파일이 설치된 AWS 리전에 있어야 합니다. 이 프로필은 사용자가 Amazon Q Developer Pro를 처음 구독할 때 설치되었습니다. 이 프로파일과 프로파일이 지원되는 리전에 대한 자세한 내용은 Amazon Q Developer 프로파일이란 무엇입니까?및 섹션을 참조하세요Q Developer 콘솔 및 Q Developer 프로파일에 지원되는 리전.

  • 사용자가 구독하는 AWS 계정에 있어야 합니다. 사용자가 여러 AWS 계정에서 구독하는 경우 각 계정에서 버킷을 생성해야 합니다. 교차 계정 버킷은 지원되지 않습니다.

  • 다음과 같은 버킷 정책이 있습니다. bucketName, region, accountId, prefix를 자신의 정보로 바꿉니다.

    JSON
    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "QDeveloperLogsWrite",
            "Effect": "Allow",
            "Principal": {
                "Service": "q.amazonaws.com"
            },
            "Action": [
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::bucketName/prefix/*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "accountId"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:codewhisperer:us-east-1:accountId:*"
                }
            }
        }
    ]
}

    버킷에서 SSE-KMS를 구성하는 경우 KMS 키에 다음 정책을 추가합니다.

    {
    "Effect": "Allow",
    "Principal": {
        "Service": "q.amazonaws.com"
    },
    "Action": "kms:GenerateDataKey",
    "Resource": "*",
    "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "accountId" 
        },
        "ArnLike": {
           "aws:SourceArn": "arn:aws:codewhisperer:region:accountId:*"
        }
    }
}

    Amazon S3 버킷의 데이터 보호에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 암호화를 사용한 데이터 보호를 참조하세요.

프롬프트 로깅을 활성화하는 방법

  1. Amazon Q Developer 콘솔을 엽니다.

    Amazon Q Developer 콘솔을 사용하려면에 정의된 권한이 있어야 합니다관리자가 Amazon Q Developer 콘솔을 사용하도록 허용.

    참고

    독립 실행형 계정 관리자 또는 관리 계정 관리자로 로그인해야 합니다. 멤버 계정 관리자는 프롬프트 로깅을 활성화할 수 없습니다.

  2. 설정을 선택합니다.

  3. 기본 설정에서 편집을 선택합니다.

  4. 기본 설정 편집 창에서 Q Developer 프롬프트 로깅을 전환합니다.

  5. Amazon S3 위치 아래에 로그를 수신하는 데 사용할 Amazon S3 URI를 입력합니다. 예시: s3://amzn-s3-demo-bucket/qdev-prompt-logs/