AWS 생성형 AI 자격증 학습요약본원본·요약본 목록은 자료실 페이지에서

06 · 모델 호출 로깅 — CloudWatch Logs와 S3

한 문장 요약: 모델 호출 로깅은 리전·계정 단위로 켜지는 계정 수준 스위치로, Converse·InvokeModel 계열 호출의 입력·출력·메타데이터를 CloudWatch Logs와 S3에 남기며, 로그 항목에서 호출자가 채우는 유일한 필드는 requestMetadata다.

개요

호출 로깅을 사용하면 리전의 AWS 계정에서 이루어지는 Bedrock 호출 전체에 대해 호출 로그·모델 입력·출력 데이터를 수집한다. 대상은 CloudWatch Logs와 S3(동일 계정·리전만), 기본 비활성화이며 활성화 시 로깅 구성이 삭제될 때까지 로그가 저장된다.

핵심 메시지 3

1. 계정·리전 스위치다 — 모델별·앱별 설정이 아니라 해당 리전 계정의 "지원되는 모든 호출"을 일괄 수집한다. 과금·프라이버시 영향이 큰 이유.

2. 수집 범위의 경계가 있다 — 로깅되는 작업은 Converse·ConverseStream·InvokeModel·InvokeModelWithResponseStream이며 bedrock-runtime 엔드포인트만 해당(OpenAI 호환 API 포함), bedrock-mantle 등 다른 엔드포인트 호출은 캡처되지 않는다 (원문).

3. requestMetadata가 유일한 호출자 필드다 — 로그 항목의 다른 모든 필드는 Bedrock이 자동 채움. 토큰을 팀·앱·환경별로 분류하려면 이 태그(또는 identity.arn 그룹화)를 쓴다.

주제별 심화

대상 설정

대상요구 사항
S3버킷은 모델 호출 로깅 구성을 생성하는 계정·리전과 동일해야 함 · 버킷 정책으로 bedrock.amazonaws.com의 s3:PutObject 허용(SourceAccount/SourceArn 조건) · SSE-KMS 시 kms:GenerateDataKey 허용 · 버킷 ACL 비활성화 필요
CloudWatch Logs로그 그룹 + IAM 역할(신뢰: bedrock.amazonaws.com / 권한: logs:CreateLogStream·PutLogEvents, 스트림 aws/bedrock/modelinvocations)

데이터 형태 규칙

API·로그 항목

적용 체크리스트 (시험·실습 관점)

최종 정리

로깅은 "무엇이 남는가(입력·출력·메타데이터)·어디에(CW/S3·100KB 규칙)·누가 나누는가(requestMetadata)"의 3질문으로 정리된다. 4주차 점검 항목 "모델 입출력 로그에 담길 데이터"의 원형이 이 문서다.


Provenance: 원문 인용·쿼리는 2026-11-18 수집 본문 기준. 기계 번역 한국어 문서로 원문 영어 우선 고지. 해석·체크리스트는 학습용 편집임.