프롬프트 로깅

Kiro 사용자가 Kiro IDE에 입력하는 프롬프트를 관리자가 파악할 수 있도록 돕는 문서입니다.

Kiro 관리자는 사용자가 Kiro IDE에서 주고받는 모든 인라인 제안과 채팅 대화의 로깅을 활성화할 수 있습니다. 이 로그는 감사, 디버깅, 분석, 컴플라이언스 준수에 활용할 수 있습니다.

프롬프트 로그 정보

프롬프트 로깅을 활성화하면 Kiro는 사용자 프롬프트와 Kiro의 응답을 모두 기록합니다. Kiro는 이 로그를 여러분 계정 내의 지정한 Amazon S3 버킷에 저장합니다. 로그 파일 내용에 대한 예시와 설명은 프롬프트 로그 예시를 참고하세요.

프롬프트 로깅 기능 자체에는 요금이 부과되지 않으며, 로그를 보관하는 Amazon S3 버킷의 스토리지 비용과 버킷 암호화에 사용하는 선택적 KMS 키에 대한 소액의 요금만 발생합니다.

프롬프트 로깅 활성화

사전 요구사항

• 프롬프트 로그를 보관할 Amazon S3 버킷을 생성합니다. 이 버킷은 다음 조건을 충족해야 합니다.
  • Kiro 프로필이 설치된 AWS 리전에 있어야 합니다. 이 프로필은 사용자를 Kiro Pro에 처음 구독시킬 때 설치되었습니다. 이 프로필과 지원 리전에 대한 자세한 내용은 개념과 지원 리전을 참고하세요.
  • 사용자가 구독된 AWS 계정에 있어야 합니다.
  • 아래와 같은 버킷 정책을 가지고 있어야 합니다. bucketName, Region, accountId, prefix는 여러분의 정보로 바꿉니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "KiroLogsWrite",
      "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:*"
        }
      }
    }
  ]
}

Amazon S3 버킷의 데이터를 보호하는 방법은 Amazon Simple Storage Service 사용 설명서의 암호화로 데이터 보호를 참고하세요.

프롬프트 로깅 활성화하기

1. Kiro 콘솔을 엽니다.
2. Settings를 선택합니다.
3. Kiro Settings > Logging을 찾습니다.
4. Log Kiro prompts with metadata 스위치를 켭니다.
5. Amazon S3 location에 로그를 수신할 Amazon S3 URI를 입력합니다. 예: s3://amzn-s3-demo-bucket/kiro-prompt-logs/

프롬프트 로그 예시

이 섹션에서는 Kiro가 생성하는 프롬프트 로그의 예시를 제공합니다.

각 예시 다음에는 로그 파일의 필드를 설명하는 표가 이어집니다.

인라인 제안 로그 예시

다음 예시는 사용자가 인라인 제안을 수락했을 때 생성되는 로그 파일을 보여줍니다.

{
  "records": [
    {
      "generateCompletionsEventRequest": {
        "leftContext": "import * cdk from 'aws-cdk-lib';\r\nimport * s3 from 'aws-cdk-lib/aws-s3';\r\nimport { Stack, StackProps } from 'constructs';\r\nexport class MyStack extends Stack {\r\n  constructor(scope: cdk.App, id: string, props?: StackProps) {\r\n    super(scope, id, props);\r\n\r\n    new s3.Bucket(this, 'XXXXXXXX', {\r\n      versioned: true\r\n    });\r\n  }\r\n ",
        "rightContext": "",
        "fileName": "cdk-modified.ts",
        "customizationArn": null,
        "userId": "d-92675051d5.b8f1f340-9081-70ad-5fc5-0f37151937a6",
        "timeStamp": "2025-01-06T15:09:16.412719Z"
      },
      "generateCompletionsEventResponse": {
        "completions": ["synth() {\n    return cdk.App.prototype.synth.apply(this, arguments);\n  }"],
        "requestId": "797c70ee-abc9-4cc7-a148-b9df17f6ce48"
      }
    }
  ]
}

다음 표는 인라인 제안 로그 파일의 필드를 설명합니다.

채팅 로그 예시

다음 예시는 사용자가 IDE에서 Kiro와 채팅할 때 생성되는 로그 파일을 보여줍니다.

{
  "records": [
    {
      "generateAssistantResponseEventRequest": {
        "prompt": "Can you explain how to set up object-level access control in an S3 bucket using AWS CDK?",
        "chatTriggerType": "MANUAL",
        "customizationArn": null,
        "userId": "d-92675051d5.b8f1f340-9081-70ad-5fc5-0f37151937a6",
        "timeStamp": "2025-01-06T15:05:56.313070Z"
      },
      "generateAssistantResponseEventResponse": {
        "assistantResponse": "I'll explain how to set up object-level access control for an S3 bucket using AWS CDK...",
        "followupPrompts": "How can you implement multi-factor authentication for S3 bucket access using AWS CDK?",
        "messageMetadata": {
          "conversationId": "491bd3cd-d70d-40c0-a452-5ef3f0878422",
          "utteranceId": null
        },
        "codeReferenceEvents": [],
        "supplementaryWebLinksEvent": [
          {
            "uri": "https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ManageACLs_section.html",
            "title": "[1] Manage access control lists (ACLs) for Amazon S3 buckets using an AWS SDK",
            "snippet": "The following code example shows how to manage access control lists (ACLs) for Amazon S3 buckets..."
          }
        ],
        "requestId": "dad38fc0-815c-45f7-970a-db916cb7f131"
      }
    }
  ]
}