# Amazon IVS Chat 모니터링
<a name="chat-health"></a>

Amazon CloudWatch를 사용하여 Amazon Interactive Video Service(IVS) 챗 리소스를 모니터링할 수 있습니다. CloudWatch는 Amazon IVS Chat에서 원시 데이터를 수집하고 실시간에 가깝게 읽기 가능한 지표로 프로세싱합니다. 이러한 통계는 15개월간 보관되므로 웹 애플리케이션 또는 서비스의 과거 수행 방식을 파악할 수 있습니다. 특정 임계값을 설정하고 해당 임계값이 충족될 때 알림을 전송하거나 조치를 취할 수 있습니다. 자세한 내용은 [CloudWatch 사용 설명서](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)를 참조하세요.

## CloudWatch 지표 액세스
<a name="chat-health-cloudwatch-metrics"></a>

Amazon CloudWatch는 Amazon IVS Chat에서 원시 데이터를 수집하고 실시간에 가깝게 읽기 가능한 지표로 프로세싱합니다. 이러한 통계는 15개월간 보관되므로 웹 애플리케이션 또는 서비스의 과거 수행 방식을 파악할 수 있습니다. 특정 임계값을 설정하고 해당 임계값이 충족될 때 알림을 전송하거나 조치를 취할 수 있습니다. 자세한 내용은 [CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)를 참조하세요.

CloudWatch 지표는 시간이 지나면 롤업됩니다. 지표가 오래되면서 해상도가 실질적으로 감소합니다. 일정은 다음과 같습니다.
+ 60초 지표는 15일 동안 사용할 수 있습니다.
+ 5분 지표는 63일 동안 사용할 수 있습니다.
+ 1시간 지표는 455일(15개월) 동안 사용할 수 있습니다.

데이터 보존에 대한 최신 정보를 보려면 [Amazon CloudWatch FAQ](https://aws.amazon.com/cloudwatch/faqs/)에서 '보존 기간'을 검색합니다.

### CloudWatch 콘솔 지침
<a name="chat-health-cloudwatch-metrics-console"></a>

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 측면 탐색에서 **지표** 드롭다운을 확장한 다음 **모든 지표**를 선택합니다.

1. **검색** 탭에서 왼쪽에 있는 레이블이 없는 드롭다운을 사용하여 채널이 생성된 '홈' 리전을 선택합니다. 리전에 대한 자세한 내용은 [글로벌 솔루션, 리전별 제어](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/what-is.html#what-is-aws)를 참조하세요. 지원되는 리전 목록은 *AWS 일반 참조*의 [Amazon IVS 페이지](https://docs.aws.amazon.com/general/latest/gr/ivs.html)를 참조하세요.

1. **검색** 탭 하단에서 **IVSChat** 네임스페이스를 선택합니다.

1. 다음 중 하나를 수행하세요.

   1. 검색 창에 리소스 ID(ARN의 일부, `arn:::ivschat:room/<resource id>`)를 입력합니다.

      그런 다음 **IVSChat**을 선택합니다.

   1. **IVSChat**이 **AWS 네임스페이스** 아래에서 선택 가능한 서비스로 나타나면 이를 선택합니다. IVSChat은 Amazon IVSChat을 사용하고 Amazon CloudWatch에 지표를 전송하는 경우에 나열됩니다. (**IVSChat**이 목록에 없으면 Amazon IVSChat 지표가 없는 것입니다.)

      그리고 나서 필요할 경우 *차원* 그룹화를 선택하세요. 아래의 [CloudWatch 지표](#chat-health-cloudwatch-metrics-chat)에 사용 가능한 차원이 나열되어 있습니다.

1. 지표를 선택하여 그래프에 추가합니다. 아래의 [CloudWatch 지표](#chat-health-cloudwatch-metrics-chat)에 사용 가능한 지표가 나열되어 있습니다.

챗 세션의 세부 정보 페이지에서 **CloudWatch에서 보기** 버튼을 선택하여 챗 세션의 CloudWatch 차트에 액세스할 수도 있습니다.

### CLI 지침
<a name="chat-health-cloudwatch-metrics-cli"></a>

AWS CLI를 사용하여 지표에 액세스할 수도 있습니다. 그러려면 먼저 시스템에 CLI를 다운로드하여 구성해야 합니다. 자세한 내용은 [AWS 명령줄 인터페이스 사용 설명서](https://docs.aws.amazon.com//cli/latest/userguide/cli-chap-welcome.html)를 참조하세요.

그런 다음 AWS CLI를 사용하여 Amazon IVS 저지연 챗 지표에 액세스하려면 다음을 수행합니다.
+ 명령 프롬프트에서 다음을 실행합니다.

  ```
  aws cloudwatch list-metrics --namespace AWS/IVSChat
  ```

자세한 내용은 *Amazon CloudWatch 사용 설명서*에서 [Amazon CloudWatch 지표 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)을 참조하세요.

## CloudWatch 지표: IVS 챗
<a name="chat-health-cloudwatch-metrics-chat"></a>

Amazon IVS Chat은 **AWS/IVSChat** 네임스페이스에서 다음 지표를 제공합니다.


| 지표 | 측정 기준 | 설명 | 
| --- | --- | --- | 
|  `ConcurrentChatConnections`  | 없음 |  채팅룸의 총 동시 연결 수(분당 보고된 최대 수)입니다. 이는 고객이 리전의 동시 채팅 연결 한도에 도달하는 경우를 파악하는 데 유용합니다. 단위: 수 유효한 통계: 합계, 평균, 최대, 최소  | 
|  `Deliveries`  | 작업 |  한 리전의 모든 방에서 특정 작업 유형으로 이루어진 채팅 연결에 대한 메시징 요청 전달 횟수입니다. 단위: 수 유효한 통계: 합계, 평균, 최대, 최소  | 
|  `InvocationErrors`  | `Uri` |  리전의 모든 방에서 특정 메시지 검토 핸들러의 호출 오류 수입니다. 메시지 검토 핸들러를 호출할 수 없는 경우 호출 오류가 발생합니다. Amazon IVS Chat이 핸들러를 호출할 수 없는 경우 호출 오류가 발생합니다. 방과 연결된 핸들러가 더 이상 존재하지 않거나 시간 초과된 경우 또는 리소스 정책이 서비스에서 호출하는 것을 허용하지 않는 경우 이러한 오류가 발생할 수 있습니다. 단위: 수 유효한 통계: 합계, 평균, 최대, 최소  | 
|  `LogDestinationAccessDeniedError`  | `LoggingConfiguration` |  리전의 모든 방에서 로그 대상의 액세스 거부 오류 수입니다. Amazon IVS Chat이 로깅 구성에서 지정한 대상 리소스에 액세스할 수 없을 때 이러한 오류가 발생합니다. 대상 리소스 정책이 서비스에서 레코드 저장을 허용하지 않는 경우 이러한 오류가 발생할 수 있습니다. 단위: 수 유효한 통계: 합계, 평균, 최대, 최소  | 
|  `LogDestinationErrors`  | `LoggingConfiguration` |  리전의 모든 방에서 로그 대상의 모든 오류 수입니다. 이것은 Amazon IVS Chat이 로깅 구성에서 지정한 대상 리소스에 로그를 전달하지 못할 때 발생하는 모든 유형의 오류를 포함하는 집계된 지표입니다. 단위: 수 유효한 통계: 합계, 평균, 최대, 최소  | 
|  `LogDestinationResourceNotFoundErrors`  | `LoggingConfiguration` |  리전의 모든 방에서 로그 대상의 리소스를 찾을 수 없는 오류 수입니다. 이러한 오류는 Amazon IVS Chat이 로깅 구성에서 지정한 대상 리소스가 존재하지 않아 대상 리소스에 로그를 전달할 수 없을 때 발생합니다. 이것은 로깅 구성과 연결된 대상 리소스가 더 이상 존재하지 않는 경우 발생할 수 있습니다. 단위: 수 유효한 통계: 합계, 평균, 최대, 최소  | 
|  `MessagingDeliveries`  | 없음 |  한 리전의 모든 방에서 채팅 연결에 대한 메시징 요청 전달 횟수입니다. 단위: 수 유효한 통계: 합계, 평균, 최대, 최소  | 
|  `MessagingRequests`  | 없음 |  한 리전의 모든 방에서 이루어진 메시징 요청 수입니다. 단위: 수 유효한 통계: 합계, 평균, 최대, 최소  | 
|  `Requests`  | 작업 | 한 리전의 모든 방에서 특정 작업 유형으로 이루어진 요청 수입니다. 단위: 수 유효한 통계: 합계, 평균, 최대, 최소  | 
|  `ResponseValidationErrors`  | `Uri` |  리전의 모든 방에서 특정 메시지 검토 핸들러의 응답-검증 오류 수입니다. 메시지 검토 핸들러의 응답이 유효하지 않은 경우 응답-검증 오류가 발생합니다. 이는 응답을 구문 분석할 수 없거나 검증 확인에 실패했음을 의미할 수 있습니다(예: 잘못된 검토 결과 또는 너무 긴 응답 값). 단위: 수 유효한 통계: 합계, 평균, 최대, 최소  |