기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Chime SDK 회의에 대한 로깅 및 모니터링 설정
<a name="ts-log-monitor"></a>

로깅은 서버 측 회의 이벤트 및 클라이언트 측 브라우저 콘솔 로그와 같은 정보를 수집하는 데 도움이 됩니다.

Amazon Chime SDK는 Amazon EventBridge 및 Amazon CloudWatch Events 로그로 전송할 수 있는 서버 측 회의 이벤트를 제공합니다. CloudWatch 지표 및 인사이트를 생성하여 대시보드에서 모니터링에 사용할 수 있습니다. 블로그 게시물 [Server-side Logging and Monitoring of Amazon Chime SDK events](https://aws.amazon.com/blogs/business-productivity/server-side-logging-and-monitoring-of-amazon-chime-sdk-events/)에서는 CloudWatch 지표, 인사이트 및 대시보드를 활성화하는 방법을 설명합니다.

Amazon Chime SDK는 오디오 및 비디오 품질, 네트워크 대역폭, 연결 문제에 대한 클라이언트 측 이벤트를 제공합니다. 블로그 게시물 [Monitoring and troubleshooting with Amazon Chime SDK Meeting events](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/)에서는 참여 실패, 오디오 품질 문제, 마이크 및 카메라 설정 실패에 대해 CloudWatch 지표, 인사이트 및 대시보드를 활성화하는 방법을 설명합니다. 회의 이벤트에 대한 추가 정보는 Github의 [Meeting Events](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/06_Meeting_Events.md)를 참조하세요.



## 문제 해결 지표 옵션
<a name="ts-cloudwatch-options"></a>

문제 해결 이벤트를 수집하는 옵션은 다음과 같습니다.
+ 모든 이벤트에서 지표 전송 
+ N초마다 이벤트 배치 
+ 회의 종료 시 지표 전송 
+ 브라우저 콘솔 로그의 로깅 수준

## 권장 지표
<a name="ts-cloudwatch-metrics"></a>

최소한 다음 지표를 수집하고 기록해야 합니다.
+ SDK 플랫폼 및 버전
+ 브라우저 및 버전
+ 운영 체제
+ 논리 코어
+ 회의 시작
+ 회의 종료
+ 참석자 참여
+ 참석자 퇴장
+ 참석자 감소

또한 직면한 문제에 따라 다음 지표는 연결, 대역폭 및 품질 문제에 대한 정보를 제공할 수 있습니다. 이러한 지표가 발생할 때마다 기록하거나 집계만 할 수 있습니다. 집계를 통해 근본적인 문제를 요약하여 확인할 수 있습니다.
+ connectionDidSuggestStopVideo
+ connectionDidBecomeGood
+ connectionDidBecomePoor
+ Attendee join time > t seconds
+ MeetingStartFailed
+ MeetingFailed

## 클라이언트 측 로깅 활성화
<a name="client-side-logging"></a>

`ConsoleLogger` 객체에 `LogLevel.INFO`를 전달하여 `INFO` 수준 브라우저 로그를 활성화할 수 있습니다.

```
const logger = new ConsoleLogger('MyLogger', LogLevel.INFO);const meetingSession = new DefaultMeetingSession(configuration,logger,deviceController); 
```

또한 Amazon Chime SDK for JavaScript의 `POSTLogger` 구성 요소를 사용하여 Amazon CloudWatch Logs와 같은 백엔드의 브라우저 로그를 캡처할 수 있습니다. `POSTLogger`는 `HTTP POST`가 [POSTLogger 생성자](https://aws.github.io/amazon-chime-sdk-js/classes/postlogger.html)의 주어진 URL에 브라우저 로그를 업로드하는 요청을 하도록 합니다. 예를 들어, [GitHub의 Amazon Chime SDK 서버리스 데모](https://github.com/aws/amazon-chime-sdk-js/blob/main/demos/browser/app/meetingV2/meetingV2.ts#L1773)는 향후 조사를 위해 `POSTLogger`를 사용하여 브라우저 로그를 Amazon CloudWatch Logs로 보냅니다.

## 서버 측 로깅 활성화
<a name="server-side-logging"></a>

Amazon Chime SDK for JavaScript는 `MeetingStartFailed` 및 `MeetingFailed`와 같은 주요 회의 이벤트를 사용하여 `eventDidReceive` 옵저버 메서드도 직접 호출합니다. 회의 이벤트에는 종종 실패의 구체적인 이유가 포함됩니다. 예를 들어, 대규모 고객 그룹이 실패를 경험한다고 가정해 보겠습니다. 웹 애플리케이션은 이러한 회의 이벤트를 수집한 다음 당사와 공유하여 근본 원인을 해결할 수 있습니다. 회의 이벤트에 대한 자세한 내용은 [GitHub의 회의 이벤트 지침](https://aws.github.io/amazon-chime-sdk-js/modules/meetingevents.html) 및 블로그 게시물 [Monitoring and troubleshooting with Amazon Chime SDK meeting events](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/)를 참조하세요.