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

# Amazon Q Developer에서 사용자의 프롬프트 로깅
<a name="q-admin-prompt-logging"></a>

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

개발자가 인라인 제안을 사용하면 Amazon Q는 수락된 제안과 적극적으로 거부된 제안을 로깅합니다. 개발자가 Amazon Q와 채팅하는 경우 Amazon Q는 개발자의 프롬프트와 Amazon Q의 응답을 모두 로깅합니다. 개발자가 **/dev** 명령을 사용하여 [소프트웨어 개발을 위한 Amazon Q 에이전트](q-in-IDE-chat.md#develop-code)와 채팅하는 경우 해당 프롬프트만 로깅됩니다.

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의 프롬프트 로그 예제](q-admin-prompt-log-examples.md) 섹션을 참조하세요.

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

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

**사전 조건**
+ 사용자가 독립 실행형 계정 또는 [AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html)를 사용하는 경우 관리 계정에서 구독하는지 확인합니다. 현재 Q Developer는 AWS Organizations의 멤버 계정에서 구독하는 사용자의 프롬프트 로깅을 지원하지 않습니다.
+ Amazon S3 버킷을 생성하여 프롬프트 로그를 보관합니다. 버킷은 다음과 같아야 합니다.
  + Amazon Q Developer 프로파일이 설치된 AWS 리전에 있어야 합니다. 이 프로필은 사용자를 Amazon Q Developer Pro에 처음 구독할 때 설치되었습니다. 이 프로필과 해당 프로필이 지원되는 리전에 대한 자세한 내용은 [Amazon Q Developer 프로필이란 무엇입니까?](subscribe-understanding-profile.md) 및 [Q Developer 콘솔 및 Q Developer 프로필에 지원되는 리전](q-admin-setup-subscribe-regions.md#qdev-console-and-profile-regions) 섹션을 참조하세요.
  + 사용자가 구독하는 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": "{{111122223333}}"
                    },
                    "ArnLike": {
                    "aws:SourceArn": "arn:aws:codewhisperer:{{us-east-1}}:{{111122223333}}:*"
                    }
                }
            }
        ]
    }
    ```

------

    버킷에 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 사용 설명서*의 [암호화를 사용한 데이터 보호](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingEncryption.html)를 참조하세요.

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

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

   Amazon Q Developer 콘솔에 액세스하려면 [관리자가 Amazon Q Developer 콘솔을 사용하도록 허용](id-based-policy-examples-admins.md#q-admin-setup-admin-users)에 정의된 권한이 있어야 합니다.
**참고**  
독립 실행형 계정 관리자 또는 관리 계정 관리자로 로그인해야 합니다. 멤버 계정에서 구독하는 사용자에게는 프롬프트 로깅이 지원되지 않으므로 멤버 계정 관리자는 프롬프트 로깅을 활성화할 수 없습니다.

1. **설정**을 선택합니다.

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

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

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