IVS 챗 로깅

채팅 로깅 기능은 방에 있는 모든 채팅 메시지를 Amazon S3 버킷, Amazon CloudWatch Logs 또는 Amazon Kinesis Data Firehose에 기록할 수 있습니다. 이후 로그는 분석이나 라이브 비디오 세션으로 연결되는 채팅 리플레이를 만드는 데 사용될 수 있습니다.

채팅룸에 대한 채팅 로깅 활성화

채팅 로깅은 로깅 구성을 채팅룸과 연결하여 활성화할 수 있는 고급 옵션입니다. 로깅 구성은 채팅룸의 메시지가 기록되는 위치 유형(Amazon S3 버킷, Amazon CloudWatch Logs 또는 Amazon Kinesis Data Firehose)을 지정할 수 있는 리소스입니다. 로깅 구성 생성 및 관리에 대한 자세한 내용은 Amazon IVS Chat 시작하기 및 Amazon IVS Chat API 참조를 확인하세요.

새 방을 만들 때(CreateRoom) 또는 기존 방을 업데이트할 때(UpdateRoom) 각 방에 최대 3개의 로깅 구성을 연결할 수 있습니다. 여러 방을 동일한 로깅 구성에 연결할 수 있습니다.

하나 이상의 활성 로깅 구성이 방과 연결되면 Amazon IVS Chat Messaging API를 통해 해당 방에 전송된 모든 메시징 요청이 지정한 위치에 자동으로 기록됩니다. 다음은 평균 전파 지연 시간(메시징 요청이 전송된 시점부터 지정한 위치에서 사용할 수 있게 되는 시점까지)입니다.

• Amazon S3 버킷: 5분

• Amazon CloudWatch Logs 또는 Amazon Kinesis Data Firehose: 10초

메시지 콘텐츠

형식

{
   "event_timestamp": "string",
   "type": "string",
   "version": "string",
   "payload": { "string": "string" }
}

필드

필드	설명
event_timestamp	Amazon IVS Chat에서 메시지를 받은 시점의 UTC 타임스탬프입니다.
payload	클라이언트가 Amazon IVS Chat 서비스에서 받게 되는 메시지(구독) 또는 이벤트(구독) JSON 페이로드입니다.
type	채팅 메시지의 유형입니다. 유효한 값: MESSAGE | EVENT
version	메시지 콘텐츠 형식의 버전입니다.

Amazon S3 버킷

형식

메시지 로그는 다음과 같은 S3 접두사와 파일 형식으로 구성되고 저장됩니다.

AWSLogs/<account_id>/IVSChatLogs/<version>/<region>/room_<resource_id>/<year>/<month>/<day>/<hours>/<account_id>_IVSChatLogs_<version>_<region>_room_<resource_id>_<year><month><day><hours><minutes>_<hash>.log.gz

필드

필드	설명
<account_id>	방이 생성되는 AWS 계정 ID입니다.
<hash>	고유성을 보장하기 위해 시스템에서 생성한 해시 값입니다.
<region>	방이 생성된 AWS 서비스 리전입니다.
<resource_id>	방 ARN의 리소스 ID 부분입니다.
<version>	메시지 콘텐츠 형식의 버전입니다.
<year> / <month> / <day> / <hours> / <minute>	Amazon IVS Chat에서 메시지를 받은 시점의 UTC 타임스탬프입니다.

예제

AWSLogs/123456789012/IVSChatLogs/1.0/us-west-2/room_abc123DEF456/2022/10/14/17/123456789012_IVSChatLogs_1.0_us-west-2_room_abc123DEF456_20221014T1740Z_1766dcbc.log.gz

Amazon CloudWatch Logs

형식

메시지 로그는 다음과 같은 로그 스트림 이름 형식으로 구성되고 저장됩니다.

aws/IVSChatLogs/<version>/room_<resource_id>

필드

필드	설명
<resource_id>	방 ARN의 리소스 ID 부분입니다.
<version>	메시지 콘텐츠 형식의 버전입니다.

예제

aws/IVSChatLogs/1.0/room_abc123DEF456

Amazon Kinesis Data Firehose

메시지 로그는 Amazon Redshift, Amazon OpenSearch Service, Splunk 및 사용자 지정 HTTP 엔드포인트 또는 지원되는 서드 파티 서비스 제공업체가 소유한 HTTP 엔드포인트와 같은 대상에 실시간 스트리밍 데이터로 전송됩니다. 자세한 내용은 Amazon Kinesis Data Firehose란 무엇인가요?(What Is Amazon Kinesis Data Firehose?)를 참조하세요.

제약 조건

• 메시지가 저장될 로깅 위치를 소유해야 합니다.

• 방, 로깅 구성 및 로깅 위치는 동일한 AWS 리전에 있어야 합니다.

• 채팅 로깅에는 활성 로깅 구성만 사용할 수 있습니다.

• 어느 채팅룸과도 더 이상 연결되지 않는 로깅 구성만 삭제할 수 있습니다.

사용자가 소유한 위치에 메시지를 로깅하려면 AWS 보안 인증으로 권한을 부여해야 합니다. IVS Chat에 필요한 액세스 권한을 부여하려면 로깅 구성을 생성할 때 리소스 정책(Amazon S3 버킷이나 CloudWatch Logs 로그의 경우) 또는 AWS IAM 서비스 연결 역할(SLR)(Amazon Kinesis Data Firehose Firehose의 경우)이 자동으로 생성됩니다. 역할이나 정책을 수정하면 채팅 로깅 권한에 영향을 미칠 수 있으므로 주의해야 합니다.

Amazon CloudWatch로 오류 모니터링

Amazon CloudWatch를 사용하여 채팅 로깅에서 발생하는 오류를 모니터링할 수 있으며, 특정 오류의 변경 사항을 표시하거나 이에 대응하는 경보나 대시보드를 생성할 수 있습니다.

다음과 같은 여러 유형의 오류가 있습니다. 자세한 내용은 Amazon IVS Chat 모니터링을 참조하세요.