06 · 모델 호출 로깅 — CloudWatch Logs와 S3
한 문장 요약: 모델 호출 로깅은 리전·계정 단위로 켜지는 계정 수준 스위치로, Converse·InvokeModel 계열 호출의 입력·출력·메타데이터를 CloudWatch Logs와 S3에 남기며, 로그 항목에서 호출자가 채우는 유일한 필드는 requestMetadata다.
- 태스크: T-DOC-06 · 연계 주차: 4주차(보안·거버넌스)
- 원본: docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/model-invocation-logging.html (2026-11-18 수집·본문 7,601자)
- 원문 사본:
downloads/11-호출로깅/model-invocation-logging.html
개요
호출 로깅을 사용하면 리전의 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) |
데이터 형태 규칙
- 콘솔에서 기록할 출력 형식 선택: 텍스트·이미지·임베딩·비디오 — 선택 시 해당 형식을 지원하는 모든 모델의 호출이 기록됨
- 게시 위치: S3만 / CloudWatch만 / 양쪽 — 대규모 입력·출력·바이너리 이미지 출력은 S3만 지원
- 레코드당 최대 100KB 인라인 — 초과 본문·바이너리는 S3에 별도 객체로 업로드되고 로그 항목은 위치 참조
- S3은 Gzip 압축 JSON 배치 — Athena·S3 Select·Glue·OpenSearch·EventBridge로 후처리 / CloudWatch는 Insights 쿼리·실시간 스트리밍
- Converse 사용 시 전달한 이미지·문서 데이터는 S3에 기록(전송·이미지 로깅 활성화 시)
API·로그 항목
- 구성 API:
PutModelInvocationLoggingConfiguration·Get…·Delete… - 항목 스키마:
schemaType: ModelInvocationLog· timestamp · accountId · region · requestId · operation(예: Converse) · modelId ·identity.arn(자동) ·requestMetadata(선택·호출자) · input/output의 BodyJson + TokenCount - 원문 수록 Insights 쿼리:
identity.arn별 입력·출력 토큰 합계·호출 수 집계
적용 체크리스트 (시험·실습 관점)
- ☐ 로깅이 리전·계정 수준 스위치임을 말할 수 있는가 (도메인 3·4)
- ☐ bedrock-runtime만 캡처된다는 경계를 기억하는가
- ☐ 100KB 초과 데이터의 행방(S3 별도 객체)을 아는가
- ☐ requestMetadata — 호출자가 제공하는 유일한 필드 — 로 토큰 비용을 팀별로 분류하는 방법을 설계할 수 있는가 (도메인 4, 요약본 07 비용 태깅과 연결)
- ☐ 콘솔의 4가지 출력 형식(텍스트·이미지·임베딩·비디오) 선택이 수집 범위를 어떻게 바꾸는지 이해했는가
최종 정리
로깅은 "무엇이 남는가(입력·출력·메타데이터)·어디에(CW/S3·100KB 규칙)·누가 나누는가(requestMetadata)"의 3질문으로 정리된다. 4주차 점검 항목 "모델 입출력 로그에 담길 데이터"의 원형이 이 문서다.
Provenance: 원문 인용·쿼리는 2026-11-18 수집 본문 기준. 기계 번역 한국어 문서로 원문 영어 우선 고지. 해석·체크리스트는 학습용 편집임.