사용자별 활동 조회

사용자 활동 리포트로 관리자가 조직의 Kiro 사용 현황을 감사하고 추적하는 방법을 안내합니다.

조직에 속한 Kiro 구독자의 사용자별 활동 텔레메트리를 수집하도록 Kiro를 구성하고, 이를 일별 CSV 리포트로 전달받을 수 있습니다. 이 리포트를 사용해 사용량을 감사하고, 라이선스 할당을 최적화하며, 크레딧 및 초과 사용량을 추적하고, 개별 사용자가 여러 클라이언트에서 Kiro와 어떻게 상호작용하는지 파악할 수 있습니다.

리포트 소개

매일 협정 세계시(UTC) 오전 2시(02:00)에 Kiro는 클라이언트 유형(IDE, CLI, Plugin)별로 CSV 리포트를 생성하여 사용자의 S3 버킷에 기록합니다.

s3://bucketName/prefix/AWSLogs/accountId/KiroLogs/user_report/region/year/month/day/00/clientType_accountId_user_report_timestamp.csv

사용자 활동 리포트 활성화

사전 준비

사용자 활동 리포트 CSV 파일을 저장할 Amazon S3 버킷을 생성합니다. 버킷은 다음 조건을 충족해야 합니다.

• Kiro 프로필이 설치된 AWS 리전에 있어야 합니다. 이 프로필은 처음으로 IAM Identity Center 워크포스 사용자를 Kiro Pro에 구독시킬 때 설치됩니다. 이 프로필과 지원되는 리전에 대한 자세한 내용은 Kiro 프로필과 지원 리전을 참고하세요.
• 사용자가 구독된 AWS 계정에 있어야 합니다. 여러 AWS 계정에 사용자가 구독되어 있다면 각 계정마다 버킷을 생성해야 합니다. 교차 계정(cross-account) 버킷은 지원되지 않습니다.
• (선택 사항이지만 권장) 사용자 프롬프트 로깅에 사용하는 버킷과는 별개의 버킷을 사용하는 것이 좋습니다.
• Kiro가 CSV 파일을 저장할 접두사(prefix, 하위 폴더라고도 함)를 포함해야 합니다. CSV 파일은 버킷 루트에 저장할 수 없습니다.
• 아래와 같은 버킷 정책을 가지고 있어야 합니다. bucketName, prefix, region, accountId를 사용자 환경의 값으로 교체하세요. 정책의 Condition 블록에 있는 region과 accountId는 Kiro 프로필이 설치된 리전 및 사용자가 구독된 AWS 계정과 일치해야 합니다.

{
  "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": "accountId"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:codewhisperer:region:accountId:*"
        }
      }
    }
  ]
}

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

사용자 활동 리포트를 활성화하려면

1. AWS 콘솔에 로그인합니다.
2. Kiro 콘솔로 전환합니다. Kiro 콘솔을 사용하려면 정책: 관리자가 Kiro를 구성하고 사용자를 구독하도록 허용에 정의된 권한이 필요합니다.
3. Settings를 선택합니다.
4. Kiro user activity reports에서 Edit을 선택합니다.
5. Collect granular metrics per user를 토글합니다.
6. S3 location에 CSV 리포트를 저장할 Amazon S3 URI를 입력합니다. 예: s3://amzn-s3-demo-bucket/user-activity-reports/

활성화 후

첫 CSV 리포트는 리포트를 활성화한 이후 처음 도래하는 UTC 오전 2시에 생성되며, 이후 매일 새 파일이 기록됩니다. 리포트가 버킷에 쌓이면 Amazon Athena로 쿼리하거나, Amazon QuickSight로 추세를 시각화하거나, 기존 분석 파이프라인으로 가져올 수 있습니다.

사용자별 상세 없이 Kiro 사용 현황을 한눈에 보려면 대시보드에서 Kiro 사용량 조회를 참고하세요. 사용자 프롬프트의 내용까지 수집하려면 프롬프트 로깅을 참고하세요.

사용자 활동 리포트 지표

다음 표는 Kiro가 생성하는 사용자 활동 리포트에 포함된 지표를 설명합니다.

리포트 구조

1. 리포트는 정적 열(모델 메시지를 제외한 모든 필드)과 동적 열(모델 메시지)로 구성됩니다.
2. 모델 메시지 열의 개수는 리포트 날짜에 사용된 모델 수에 따라 달라집니다.
3. 모델 메시지 열 이름은 소문자 모델명을 알파벳 순으로 나열하며, Auto부터 시작합니다.
4. 모델 메시지 열 값은 해당 리포트 날짜에 그 모델이 사용자에 대해 처리한 메시지 수입니다. 사용자가 특정 모델을 사용하지 않았다면 열 값은 0으로 표시됩니다.

레거시 사용자 활동 리포트 지표

레거시 사용자 활동 리포트는 새로운 클라이언트별 리포트와 함께 계속 실행됩니다. 이 리포트에는 CLI 및 플러그인 사용 데이터만 포함됩니다. 일별 CSV 파일은 동일한 S3 버킷의 다음 경로에 게시됩니다.

s3://bucketName/prefix/AWSLogs/accountId/KiroLogs/by_user_analytic/Region/year/month/day/00/accountId_by_user_analytic_timestamp.csv

CSV 파일의 구성은 다음과 같습니다.

• clientType별로 하나의 CSV 파일이 생성되며, 해당 일자에 그 클라이언트와 상호작용한 모든 사용자를 포함합니다.
• 각 행은 해당 일자에 Kiro와 상호작용한 사용자를 나타냅니다.
• 각 열은 아래 표에 설명된 지표를 나타냅니다. 지표는 하루 동안 수집된 사용자 텔레메트리를 기반으로 계산됩니다.
• 하루에 1,000명을 초과하는 사용자가 Kiro와 상호작용한 경우, Kiro는 데이터를 사용자 1,000명씩 여러 CSV 파일로 분할합니다. 파일에는 part_1, part_2 등의 접미사가 붙습니다.

경로의 00 세그먼트는 UTC 오전 2시 쓰기 시각을 반영하는 고정 시간 파티션입니다.

다음 표는 Kiro가 생성하는 레거시 사용자 활동 리포트에 포함된 지표를 설명합니다.