기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon CloudWatch를 사용하여 Amazon Chime SDK 모니터링
CloudWatch를 사용하여 Amazon Chime SDK를 모니터링할 수 있습니다. CloudWatch는 원시 데이터를 수집하여 읽기 쉽고 실시간에 가까운 지표로 처리합니다. 이러한 통계는 15개월 동안 보관되므로 기록 정보에 액세스하고 웹 애플리케이션 또는 서비스의 성능을 더 잘 파악할 수 있습니다. 특정 임계값을 주시하다가 해당 임계값이 충족될 때 알림을 전송하거나 조치를 취하도록 경보를 설정할 수도 있습니다. 자세한 내용은 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)를 참조하세요.
## Amazon Chime SDK에 대한 CloudWatch 지표
Amazon Chime SDK는 CloudWatch로 다음 지표를 전송합니다. Amazon Chime SDK는 호출 기간 동안 분당 한 번씩 지표를 전송하고 여기에 나열된 모든 지표를 전송합니다.
`AWS/ChimeVoiceConnector` 네임스페이스에는 AWS 계정에 할당된 전화번호와 Amazon Chime SDK Voice Connector에 대해 다음과 같은 지표가 포함됩니다.
**참고**
SDK는 호출 기간 동안 분당 한 번씩 패킷 손실 값을 전송합니다. 손실 값은 호출 기간 동안 누적됩니다. 예를 들어 패킷 손실이 11:01에 발생하는 경우 해당 손실 값은 호출의 나머지 분 동안 전달됩니다. 호출이 끝나면 단일 패킷 손실 지표를 수신합니다.
| 지표 | 설명 |
| --- | --- |
| `SmaActiveCallCount` | 활성 동시 Sip Media Application 호출 수입니다. 단위: 개 |
| `VoiceConnectorActiveCallCount` | 활성 동시 음성 커넥터 호출 수입니다. 단위: 개 |
| `InboundCallAttempts` | 시도한 인바운드 통화 수입니다. 단위: 개 |
| `InboundCallFailures` | 인바운드 통화 실패 수입니다. 단위: 개 |
| `InboundCallsAnswered` | 응답된 인바운드 통화 수입니다. 단위: 개 |
| `InboundCallsActive` | 현재 활성 상태인 인바운드 통화 수입니다. 단위: 개 |
| `OutboundCallAttempts` | 시도한 아웃바운드 통화 수입니다. 단위: 개 |
| `OutboundCallFailures` | 아웃바운드 통화 실패 수입니다. 단위: 개 |
| `OutboundCallsAnswered` | 응답된 아웃바운드 통화 수입니다. 단위: 개 |
| `OutboundCallsActive` | 현재 활성화된 아웃바운드 통화 수입니다. 단위: 개 |
| `Throttles` | 전화를 걸려고 할 때 계정에 스로틀이 발생한 수입니다. 단위: 개 |
| `Sip1xxCodes` | 1xx 레벨 상태 코드가 있는 SIP 메시지 수입니다. 단위: 개 |
| `Sip2xxCodes` | 2xx 레벨 상태 코드가 있는 SIP 메시지 수입니다. 단위: 개 |
| `Sip3xxCodes` | 3xx 레벨 상태 코드가 있는 SIP 메시지 수입니다. 단위: 개 |
| `Sip4xxCodes` | 4xx 레벨 상태 코드가 있는 SIP 메시지 수입니다. 단위: 개 |
| `Sip5xxCodes` | 5xx 레벨 상태 코드가 있는 SIP 메시지 수입니다. 단위: 개 |
| `Sip6xxCodes` | 6xx 레벨 상태 코드가 있는 SIP 메시지 수입니다. 단위: 개 |
| `CustomerToVcRtpPackets` | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 RTP 패킷 수입니다. 단위: 개 |
| `CustomerToVcRtpBytes` | 고객으로부터 RTP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. 단위: 개 |
| `CustomerToVcRtcpPackets` | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 RTCP 패킷 수입니다. 단위: 개 |
| `CustomerToVcRtcpBytes` | RTCP 패킷에서 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. 단위: 개 |
| `CustomerToVcPacketsLost` | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. 단위: 개 |
| `CustomerToVcJitter` | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 패킷의 평균 지터입니다. 단위: 마이크로초 |
| `VcToCustomerRtpPackets` | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 RTP 패킷 수입니다. 단위: 개 |
| `VcToCustomerRtpBytes` | RTP 패킷에서 Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 바이트 수입니다. 단위: 개 |
| `VcToCustomerRtcpPackets` | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 RTCP 패킷 수입니다. 단위: 개 |
| `VcToCustomerRtcpBytes` | RTCP 패킷에서 Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 바이트 수입니다. 단위: 개 |
| `VcToCustomerPacketsLost` | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. 단위: 개 |
| `VcToCustomerJitter` | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 패킷의 평균 지터입니다. 단위: 마이크로초 |
| `RTTBetweenVcAndCustomer` | 고객과 Amazon Chime SDK Voice Connector 인프라 간의 평균 왕복 시간입니다. 단위: 마이크로초 |
| `MOSBetweenVcAndCustomer` | 고객과 Amazon Chime SDK Voice Connector 인프라 간의 음성 스트림과 관련된 예상 평균 의견 점수(MOS)입니다. 단위: 1.0-4.4의 점수. 점수가 높을수록 오디오 음질이 뛰어납니다. |
| `RemoteToVcRtpPackets` | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 RTP 패킷 수입니다. 단위: 개 |
| `RemoteToVcRtpBytes` | 원격 엔드에서 RTP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. 단위: 개 |
| `RemoteToVcRtcpPackets` | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 RTCP 패킷 수입니다. 단위: 개 |
| `RemoteToVcRtcpBytes` | 원격 엔드에서 RTCP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. 단위: 개 |
| `RemoteToVcPacketsLost` | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. 단위: 개 |
| `RemoteToVcJitter` | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 패킷의 평균 지터입니다. 단위: 마이크로초 |
| `VcToRemoteRtpPackets` | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 RTP 패킷 수입니다. 단위: 개 |
| `VcToRemoteRtpBytes` | Amazon Chime SDK Voice Connector 인프라에서 RTP 패킷의 원격 엔드로 전송된 바이트 수입니다. 단위: 개 |
| `VcToRemoteRtcpPackets` | Amazon Chime SDK 음성 커넥터 인프라에서 원격 엔드로 전송된 RTCP 패킷 수입니다. 단위: 개 |
| `VcToRemoteRtcpBytes` | RTCP 패킷의 Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 바이트 수입니다. 단위: 개 |
| `VcToRemotePacketsLost` | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. 단위: 개 |
| `VcToRemoteJitter` | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 패킷의 평균 지터입니다. 단위: 마이크로초 |
| `RTTBetweenVcAndRemote` | 원격 엔드와 Amazon Chime SDK Voice Connector 인프라 간의 평균 왕복 시간입니다. 단위: 마이크로초 |
| `MOSBetweenVcAndRemote` | 원격 엔드와 Amazon Chime SDK Voice Connector 인프라 간의 음성 스트림과 관련된 예상 평균 의견 점수(MOS)입니다. 단위: 단위: 1.0\$14.4의 점수. 점수가 높을수록 오디오 음질이 뛰어납니다. |
## Amazon Chime SDK의 CloudWatch 차원
Amazon Chime SDK와 함께 사용할 수 있는 CloudWatch 차원은 다음과 같습니다.
| 차원 | 설명 |
| --- | --- |
| `VoiceConnectorId` | 지표를 표시할 Amazon Chime SDK Voice Connector의 식별자입니다. |
| `Region` | 이벤트와 연결된 AWS 리전입니다. |
## Amazon Chime SDK에 대한 CloudWatch 로그
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\$1connector\$1id | 호출을 전달하는 Amazon Chime SDK 음성 커넥터 ID입니다. |
| event\$1timestamp | UTC 기준 메트릭이 UTC Epoch(1970년 1월 1일 자정) 이후 밀리초 단위로 내보냈을 때 시간입니다. |
| call\$1id | 거래 ID에 해당합니다. |
| from\$1sip\$1user | 호출하는 시작 사용자입니다. |
| from\$1country | 호출하는 시작 국가입니다. |
| to\$1sip\$1user | 호출하는 수신 사용자입니다. |
| to\$1country | 호출하는 수신 국가입니다. |
| endpoint\$1id | 호출의 다른 엔드포인트를 나타내는 불투명 식별자입니다. CloudWatch Logs Insights와 함께 사용합니다. 자세한 내용은 *Amazon CloudWatch Logs 사용 설명서*의 [CloudWatch Logs Insights를 사용한 로그 데이터 분석](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)을 참조하세요. |
| aws\$1region | 호출의 AWS 리전입니다. |
| cust2vc\$1rtp\$1packets | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 RTP 패킷 수입니다. |
| cust2vc\$1rtp\$1bytes | 고객으로부터 RTP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. |
| cust2vc\$1rtcp\$1packets | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 RTCP 패킷 수입니다. |
| cust2vc\$1rtcp\$1bytes | RTCP 패킷에서 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. |
| cust2vc\$1packets\$1lost | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. |
| cust2vc\$1jitter | 고객으로부터 Amazon Chime SDK Voice Connector 인프라로 전송된 패킷의 평균 지터입니다. |
| vc2cust\$1rtp\$1packets | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 RTP 패킷 수입니다. |
| vc2cust\$1rtp\$1bytes | RTP 패킷에서 Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 바이트 수입니다. |
| vc2cust\$1rtcp\$1packets | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 RTCP 패킷 수입니다. |
| vc2cust\$1rtcp\$1bytes | RTCP 패킷에서 Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 바이트 수입니다. |
| vc2cust\$1packets\$1lost | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. |
| vc2cust\$1jitter | Amazon Chime SDK Voice Connector 인프라에서 고객에게 전송된 패킷의 평균 지터입니다. |
| rtt\$1btwn\$1vc\$1and\$1cust | 고객과 Amazon Chime SDK Voice Connector 인프라 간의 평균 왕복 시간입니다. |
| mos\$1btwn\$1vc\$1and\$1cust | 고객과 Amazon Chime SDK Voice Connector 인프라 간의 음성 스트림과 관련된 예상 평균 의견 점수(MOS)입니다. |
| rem2vc\$1rtp\$1packets | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 RTP 패킷 수입니다. |
| rem2vc\$1rtp\$1bytes | 원격 엔드에서 RTP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. |
| rem2vc\$1rtcp\$1packets | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 RTCP 패킷 수입니다. |
| rem2vc\$1rtcp\$1bytes | 원격 엔드에서 RTCP 패킷의 Amazon Chime SDK Voice Connector 인프라로 전송된 바이트 수입니다. |
| rem2vc\$1packets\$1lost | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. |
| rem2vc\$1jitter | 원격 엔드에서 Amazon Chime SDK Voice Connector 인프라로 전송된 패킷의 평균 지터입니다. |
| vc2rem\$1rtp\$1packets | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 RTP 패킷 수입니다. |
| vc2rem\$1rtp\$1bytes | Amazon Chime SDK Voice Connector 인프라에서 RTP 패킷의 원격 엔드로 전송된 바이트 수입니다. |
| vc2rem\$1rtcp\$1packets | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 RTCP 패킷 수입니다. |
| vc2rem\$1rtcp\$1bytes | Amazon Chime SDK Voice Connector 인프라에서 RTCP 패킷의 원격 엔드로 전송된 바이트 수입니다. |
| vc2rem\$1packets\$1lost | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송 중에 손실된 패킷 수입니다. 값은 호출이 끝날 때까지 1분마다 전송됩니다. 값 수는 누적됩니다. |
| vc2rem\$1jitter | Amazon Chime SDK Voice Connector 인프라에서 원격 엔드로 전송된 패킷의 평균 지터입니다. |
| rtt\$1btwn\$1vc\$1and\$1rem | 원격 엔드와 Amazon Chime SDK Voice Connector 인프라 간의 평균 왕복 시간입니다. |
| mos\$1btwn\$1vc\$1and\$1rem | 원격 엔드와 Amazon Chime SDK Voice Connector 인프라 간의 음성 스트림과 관련된 예상 평균 의견 점수(MOS)입니다. |
**SIP 메시지 로그**
Amazon Chime SDK 음성 커넥터에 대한 SIP 메시지 로그를 수신하도록 선택할 수 있습니다. 이렇게 하면 Amazon Chime SDK가 인바운드 및 아웃바운드 SIP 메시지를 캡처하여 사용자를 위해 생성된 CloudWatch Logs 로그 그룹으로 전송합니다. 로그 그룹 이름은 `/aws/ChimeVoiceConnectorSipMessages/${VoiceConnectorID}`입니다. 로그에 다음과 같은 필드가 JSON 형식으로 포함됩니다.
| 필드 | 설명 |
| --- | --- |
| voice\$1connector\$1id | Amazon Chime SDK 음성 커넥터 ID입니다. |
| aws\$1region | 이벤트와 연결된 AWS 리전입니다. |
| event\$1timestamp | UTC 기준 UNIX Epoch(1970년 1월 1일 자정) 이후 밀리초 단위로 표기되는 메시지가 캡처된 시간입니다. |
| call\$1id | Amazon Chime SDK Voice Connector 호출 ID입니다. |
| sip\$1message | 캡처된 전체 SIP 메시지입니다. |