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

# Amazon CloudWatch를 사용하여 Amazon Chime SDK 모니터링
<a name="monitoring-cloudwatch"></a>

CloudWatch를 사용하여 Amazon Chime SDK를 모니터링할 수 있습니다. CloudWatch는 원시 데이터를 수집하여 읽기 쉽고 실시간에 가까운 지표로 처리합니다. 이러한 통계는 15개월 동안 보관되므로 기록 정보에 액세스하고 웹 애플리케이션 또는 서비스의 성능을 더 잘 파악할 수 있습니다. 특정 임계값을 주시하다가 해당 임계값이 충족될 때 알림을 전송하거나 조치를 취하도록 경보를 설정할 수도 있습니다. 자세한 내용은 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)를 참조하세요.

## Amazon Chime SDK에 대한 CloudWatch 지표
<a name="cw-metrics"></a>

Amazon Chime SDK는 CloudWatch로 다음 지표를 전송합니다. Amazon Chime SDK는 호출 기간 동안 분당 한 번씩 지표를 전송하고 여기에 나열된 모든 지표를 전송합니다.

`AWS/ChimeVoiceConnector` 네임스페이스에는 AWS 계정에 할당된 전화번호와 Amazon Chime SDK Voice Connector에 대해 다음과 같은 지표가 포함됩니다.

**참고**  
SDK는 호출 기간 동안 분당 한 번씩 패킷 손실 값을 전송합니다. 손실 값은 호출 기간 동안 누적됩니다. 예를 들어 패킷 손실이 11:01에 발생하는 경우 해당 손실 값은 호출의 나머지 분 동안 전달됩니다. 호출이 끝나면 단일 패킷 손실 지표를 수신합니다.


| 지표 | 설명 | 
| --- | --- | 
| `SmaActiveCallCount` | 활성 동시 Sip Media Application 호출 수입니다.<br />단위: 개 | 
| `VoiceConnectorActiveCallCount` | 활성 동시 음성 커넥터 호출 수입니다.<br />단위: 개 | 
| `InboundCallAttempts` | 시도한 인바운드 통화 수입니다.<br />단위: 개 | 
| `InboundCallFailures` | 인바운드 통화 실패 수입니다.<br />단위: 개 | 
| `InboundCallsAnswered` | 응답된 인바운드 통화 수입니다.<br />단위: 개 | 
| `InboundCallsActive` | 현재 활성 상태인 인바운드 통화 수입니다.<br />단위: 개 | 
| `OutboundCallAttempts` | 시도한 아웃바운드 통화 수입니다.<br />단위: 개 | 
| `OutboundCallFailures` | 아웃바운드 통화 실패 수입니다.<br />단위: 개 | 
| `OutboundCallsAnswered` | 응답된 아웃바운드 통화 수입니다.<br />단위: 개 | 
| `OutboundCallsActive` | 현재 활성화된 아웃바운드 통화 수입니다.<br />단위: 개 | 
| `Throttles` | 전화를 걸려고 할 때 계정에 스로틀이 발생한 수입니다.<br />단위: 개 | 
| `Sip1xxCodes` | 1xx 레벨 상태 코드가 있는 SIP 메시지 수입니다.<br />단위: 개 | 
| `Sip2xxCodes` | 2xx 레벨 상태 코드가 있는 SIP 메시지 수입니다.<br />단위: 개 | 
| `Sip3xxCodes` | 3xx 레벨 상태 코드가 있는 SIP 메시지 수입니다.<br />단위: 개 | 
| `Sip4xxCodes` | 4xx 레벨 상태 코드가 있는 SIP 메시지 수입니다.<br />단위: 개 | 
| `Sip5xxCodes` | 5xx 레벨 상태 코드가 있는 SIP 메시지 수입니다.<br />단위: 개 | 
| `Sip6xxCodes` | 6xx 레벨 상태 코드가 있는 SIP 메시지 수입니다.<br />단위: 개 | 
| `CustomerToVcRtpPackets` | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 RTP 패킷 수입니다.<br />단위: 개 | 
| `CustomerToVcRtpBytes` | 고객으로부터 RTP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다.<br />단위: 개 | 
| `CustomerToVcRtcpPackets` | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 RTCP 패킷 수입니다.<br />단위: 개 | 
| `CustomerToVcRtcpBytes` | RTCP 패킷에서 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다.<br />단위: 개 | 
| `CustomerToVcPacketsLost` | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다.<br />단위: 개 | 
| `CustomerToVcJitter` | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 패킷의 평균 지터입니다.<br />단위: 마이크로초 | 
| `VcToCustomerRtpPackets` | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 RTP 패킷 수입니다.<br />단위: 개 | 
| `VcToCustomerRtpBytes` | RTP 패킷에서 Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 바이트 수입니다.<br />단위: 개 | 
| `VcToCustomerRtcpPackets` | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 RTCP 패킷 수입니다.<br />단위: 개 | 
| `VcToCustomerRtcpBytes` | RTCP 패킷에서 Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 바이트 수입니다.<br />단위: 개 | 
| `VcToCustomerPacketsLost` | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다.<br />단위: 개 | 
| `VcToCustomerJitter` | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 패킷의 평균 지터입니다.<br />단위: 마이크로초 | 
| `RTTBetweenVcAndCustomer` | 고객과 Amazon Chime SDK Voice Connector 인프라 간의 평균 왕복 시간입니다.<br />단위: 마이크로초 | 
| `MOSBetweenVcAndCustomer` | 고객과 Amazon Chime SDK Voice Connector 인프라 간의 음성 스트림과 관련된 예상 평균 의견 점수(MOS)입니다.<br />단위: 1.0-4.4의 점수. 점수가 높을수록 오디오 음질이 뛰어납니다. | 
| `RemoteToVcRtpPackets` | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 RTP 패킷 수입니다.<br />단위: 개 | 
| `RemoteToVcRtpBytes` | 원격 엔드에서 RTP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다.<br />단위: 개 | 
| `RemoteToVcRtcpPackets` | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 RTCP 패킷 수입니다.<br />단위: 개 | 
| `RemoteToVcRtcpBytes` | 원격 엔드에서 RTCP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다.<br />단위: 개 | 
| `RemoteToVcPacketsLost` | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다.<br />단위: 개 | 
| `RemoteToVcJitter` | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 패킷의 평균 지터입니다.<br />단위: 마이크로초 | 
| `VcToRemoteRtpPackets` | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 RTP 패킷 수입니다.<br />단위: 개 | 
| `VcToRemoteRtpBytes` | Amazon Chime SDK Voice Connector 인프라에서 RTP 패킷의 원격 엔드로 전송된 바이트 수입니다.<br />단위: 개 | 
| `VcToRemoteRtcpPackets` | Amazon Chime SDK 음성 커넥터 인프라에서 원격 엔드로 전송된 RTCP 패킷 수입니다.<br />단위: 개 | 
| `VcToRemoteRtcpBytes` | RTCP 패킷의 Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 바이트 수입니다.<br />단위: 개 | 
| `VcToRemotePacketsLost` | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다.<br />단위: 개 | 
| `VcToRemoteJitter` | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 패킷의 평균 지터입니다.<br />단위: 마이크로초 | 
| `RTTBetweenVcAndRemote` | 원격 엔드와 Amazon Chime SDK Voice Connector 인프라 간의 평균 왕복 시간입니다.<br />단위: 마이크로초 | 
| `MOSBetweenVcAndRemote` | 원격 엔드와 Amazon Chime SDK Voice Connector 인프라 간의 음성 스트림과 관련된 예상 평균 의견 점수(MOS)입니다.<br />단위: 단위: 1.0\~4.4의 점수. 점수가 높을수록 오디오 음질이 뛰어납니다. | 

## Amazon Chime SDK의 CloudWatch 차원
<a name="cw-dimensions"></a>

Amazon Chime SDK와 함께 사용할 수 있는 CloudWatch 차원은 다음과 같습니다.


| 차원 | 설명 | 
| --- | --- | 
| `VoiceConnectorId` | 지표를 표시할 Amazon Chime SDK Voice Connector의 식별자입니다. | 
| `Region` | 이벤트와 연결된 AWS 리전입니다. | 

## Amazon Chime SDK에 대한 CloudWatch 로그
<a name="cw-logs"></a>

CloudWatch Logs로 지표를 전송하도록 Amazon Chime SDK 음성 커넥터를 구성할 수 있습니다. 이 경우 해당 음성 커넥터에 대한 미디어 품질 지표 로그를 수신할 수도 있습니다.

Amazon Chime SDK는 1분에 한 번씩 자세한 지표를 전송합니다. Amazon Chime SDK는 구성된 음성 커넥터로 이루어진 모든 호출에 대해 이를 전송하고 사용자를 위해 생성한 CloudWatch Logs 로그 그룹으로 전송합니다.

로그 그룹 이름은 형식을 사용합니다`/aws/ChimeVoiceConnectorLogs/${{{VoiceConnectorID}}}`.

지표를 전송하도록 음성 커넥터를 구성하는 방법에 대한 자세한 내용은 섹션을 참조하세요[Amazon Chime SDK 음성 커넥터 설정 편집](edit-voicecon.md).

**참고**  
패킷 손실 지표는 호출 기간 동안 누적됩니다. 예를 들어 패킷 손실이 11:01에 발생하는 경우 해당 손실 값은 호출의 나머지 분 동안 전달됩니다. 호출이 끝나면 단일 패킷 손실 지표를 수신합니다.

Amazon Chime SDK는 로그에 JSON 형식으로 다음 필드를 포함합니다.


| 필드 | 설명 | 
| --- | --- | 
| voice\_connector\_id | 호출을 전달하는 Amazon Chime SDK 음성 커넥터 ID입니다. | 
| event\_timestamp | UTC 기준 메트릭이 UTC Epoch(1970년 1월 1일 자정) 이후 밀리초 단위로 내보냈을 때 시간입니다. | 
| call\_id | 거래 ID에 해당합니다. | 
| from\_sip\_user | 호출하는 시작 사용자입니다. | 
| from\_country | 호출하는 시작 국가입니다. | 
| to\_sip\_user | 호출하는 수신 사용자입니다. | 
| to\_country | 호출하는 수신 국가입니다. | 
| endpoint\_id | 호출의 다른 엔드포인트를 나타내는 불투명 식별자입니다. CloudWatch Logs Insights와 함께 사용합니다. 자세한 내용은 *Amazon CloudWatch Logs 사용 설명서*의 [CloudWatch Logs Insights를 사용한 로그 데이터 분석](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)을 참조하세요. | 
| aws\_region | 호출의 AWS 리전입니다. | 
| cust2vc\_rtp\_packets | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 RTP 패킷 수입니다. | 
| cust2vc\_rtp\_bytes | 고객으로부터 RTP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. | 
| cust2vc\_rtcp\_packets | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 RTCP 패킷 수입니다. | 
| cust2vc\_rtcp\_bytes | RTCP 패킷에서 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. | 
| cust2vc\_packets\_lost | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. | 
| cust2vc\_jitter | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 패킷의 평균 지터입니다. | 
| vc2cust\_rtp\_packets | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 RTP 패킷 수입니다. | 
| vc2cust\_rtp\_bytes | RTP 패킷에서 Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 바이트 수입니다. | 
| vc2cust\_rtcp\_packets | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 RTCP 패킷 수입니다. | 
| vc2cust\_rtcp\_bytes | RTCP 패킷에서 Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 바이트 수입니다. | 
| vc2cust\_packets\_lost | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. | 
| vc2cust\_jitter | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 패킷의 평균 지터입니다. | 
| rtt\_btwn\_vc\_and\_cust | 고객과 Amazon Chime SDK Voice Connector 인프라 간의 평균 왕복 시간입니다. | 
| mos\_btwn\_vc\_and\_cust | 고객과 Amazon Chime SDK Voice Connector 인프라 간의 음성 스트림과 관련된 예상 평균 의견 점수(MOS)입니다. | 
| rem2vc\_rtp\_packets | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 RTP 패킷 수입니다. | 
| rem2vc\_rtp\_bytes | 원격 엔드에서 RTP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. | 
| rem2vc\_rtcp\_packets | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 RTCP 패킷 수입니다. | 
| rem2vc\_rtcp\_bytes | 원격 엔드에서 RTCP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. | 
| rem2vc\_packets\_lost | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. | 
| rem2vc\_jitter | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 패킷의 평균 지터입니다. | 
| vc2rem\_rtp\_packets | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 RTP 패킷 수입니다. | 
| vc2rem\_rtp\_bytes | Amazon Chime SDK Voice Connector 인프라에서 RTP 패킷의 원격 엔드로 전송된 바이트 수입니다. | 
| vc2rem\_rtcp\_packets | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 RTCP 패킷 수입니다. | 
| vc2rem\_rtcp\_bytes | Amazon Chime SDK Voice Connector 인프라에서 RTCP 패킷의 원격 엔드로 전송된 바이트 수입니다. | 
| vc2rem\_packets\_lost | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. | 
| vc2rem\_jitter | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 패킷의 평균 지터입니다. | 
| rtt\_btwn\_vc\_and\_rem | 원격 엔드와 Amazon Chime SDK Voice Connector 인프라 간의 평균 왕복 시간입니다. | 
| mos\_btwn\_vc\_and\_rem | 원격 엔드와 Amazon Chime SDK Voice Connector 인프라 간의 음성 스트림과 관련된 예상 평균 의견 점수(MOS)입니다. | 

**SIP 메시지 로그**  
Amazon Chime SDK 음성 커넥터에 대한 SIP 메시지 로그를 수신하도록 선택할 수 있습니다. 이렇게 하면 Amazon Chime SDK가 인바운드 및 아웃바운드 SIP 메시지를 캡처하여 사용자를 위해 생성된 CloudWatch Logs 로그 그룹으로 전송합니다. 로그 그룹 이름은 `/aws/ChimeVoiceConnectorSipMessages/${{{VoiceConnectorID}}}`입니다. 로그에 다음과 같은 필드가 JSON 형식으로 포함됩니다.


| 필드 | 설명 | 
| --- | --- | 
| voice\_connector\_id | Amazon Chime SDK 음성 커넥터 ID입니다. | 
| aws\_region | 이벤트와 연결된 AWS 리전입니다. | 
| event\_timestamp | UTC 기준 UNIX Epoch(1970년 1월 1일 자정) 이후 밀리초 단위로 표기되는 메시지가 캡처된 시간입니다. | 
| call\_id | Amazon Chime SDK Voice Connector 호출 ID입니다. | 
| sip\_message | 캡처된 전체 SIP 메시지입니다. |