使用 Amazon 監控亞馬遜編鐘 SDK CloudWatch

您可以使 CloudWatch 用監控 Amazon Chime 聲開發套件。 CloudWatch 收集原始數據並將其處理為可讀的近乎實時的指標。這些統計數據保留 15 個月，以便您可以訪問歷史信息，並更好地了解 Web 應用程序或服務的性能。您也可以設定留意特定閾值的警示，當滿足這些閾值時傳送通知或採取動作。如需詳細資訊，請參閱 Amazon CloudWatch 使用者指南。

CloudWatch Amazon Chime 聲 SDK 的指標

Amazon Chime SDK 會將下列指標傳送至 CloudWatch Amazon Chime SDK 會在通話期間每分鐘傳送一次指標，並傳送此處列出的所有指標。

AWS/ChimeVoiceConnector命名空間包括指派給您 AWS 帳戶的電話號碼以及 Amazon Chime SDK 語音連接器的下列指標。

注意

SDK 會在呼叫期間每分鐘傳送一次封包遺失值。損失值會在通話期間累積。例如，如果封包遺失發生在 11:01，則該遺失值會在通話的剩餘分鐘內結轉。在通話結束時，您會收到單一封包遺失量度。

指標	描述
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 語音連接器基礎設施的 RTP 封包數目。 單位：計數
CustomerToVcRtpBytes	從客戶傳送至 Amazon Chime SDK 語音連接器基礎設施的位元組數 (以 RTP 封包為單位)。 單位：計數
CustomerToVcRtcpPackets	從客戶傳送至 Amazon Chime SDK 語音連接器基礎設施的 RTCP 封包數目。 單位：計數
CustomerToVcRtcpBytes	客戶傳送至 Amazon Chime SDK 語音連接器基礎設施的位元組數 (以 RTCP 封包為單位)。 單位：計數
CustomerToVcPacketsLost	從客戶傳輸到 Amazon Chime SDK 語音連接器基礎設施時遺失的封包數目。值會每分鐘傳送一次，直到通話結束為止。值計數是累積的。 單位：計數
CustomerToVcJitter	從客戶傳送至 Amazon Chime SDK 語音連接器基礎設施的封包平均抖動。 單位：微秒
VcToCustomerRtpPackets	從 Amazon Chime SDK 語音連接器基礎設施傳送給客戶的 RTP 封包數目。 單位：計數
VcToCustomerRtpBytes	從 Amazon Chime SDK 語音連接器基礎設施傳送給客戶的位元組數 (以 RTP 封包為單位)。 單位：計數
VcToCustomerRtcpPackets	從 Amazon Chime SDK 語音連接器基礎設施傳送給客戶的 RTCP 封包數目。 單位：計數
VcToCustomerRtcpBytes	從 Amazon Chime SDK 語音連接器基礎設施傳送給客戶的位元組數 (以 RTCP 封包為單位)。 單位：計數
VcToCustomerPacketsLost	從 Amazon Chime SDK 語音連接器基礎設施傳輸至客戶的封包數目。值會每分鐘傳送一次，直到通話結束為止。值計數是累積的。 單位：計數
VcToCustomerJitter	從 Amazon Chime SDK 語音連接器基礎設施傳送給客戶的封包的平均抖動。 單位：微秒
RTTBetweenVcAndCustomer	客戶與 Amazon Chime SDK 語音連接器基礎設施之間的平均往返時間。 單位：微秒
MOSBetweenVcAndCustomer	與客戶和 Amazon Chime SDK 語音連接器基礎設施之間的語音串流相關聯的預估平均意見分數 (MOS)。 單位：介於 1.0-4.4 之間的分數。分數越高，表示感知的音訊品質越好。
RemoteToVcRtpPackets	從遠端傳送到 Amazon Chime SDK 語音連接器基礎設施的 RTP 封包數目。 單位：計數
RemoteToVcRtpBytes	從遠端傳送至 Amazon Chime SDK 語音連接器基礎設施的位元組數 (以 RTP 封包為單位)。 單位：計數
RemoteToVcRtcpPackets	從遠端傳送到 Amazon Chime SDK 語音連接器基礎設施的 RTCP 封包數目。 單位：計數
RemoteToVcRtcpBytes	從遠端傳送至 Amazon Chime SDK 語音連接器基礎設施的位元組數 (以 RTCP 封包為單位)。 單位：計數
RemoteToVcPacketsLost	從遠端傳輸到 Amazon Chime SDK 語音連接器基礎設施的傳輸中遺失的封包數目。值會每分鐘傳送一次，直到通話結束為止。值計數是累積的。 單位：計數
RemoteToVcJitter	從遠端傳送到 Amazon Chime SDK 語音連接器基礎設施的封包平均抖動。 單位：微秒
VcToRemoteRtpPackets	從 Amazon Chime SDK 語音連接器基礎設施傳送到遠端的 RTP 封包數目。 單位：計數
VcToRemoteRtpBytes	從 Amazon Chime SDK 語音連接器基礎設施傳送到遠端的位元組數 (以 RTP 封包為單位)。 單位：計數
VcToRemoteRtcpPackets	從 Amazon Chime SDK 語音連接器基礎設施傳送到遠端的 RTCP 封包數目。 單位：計數
VcToRemoteRtcpBytes	從 Amazon Chime SDK 語音連接器基礎設施傳送到遠端的位元組數 (以 RTCP 封包為單位)。 單位：計數
VcToRemotePacketsLost	從 Amazon Chime SDK 語音連接器基礎設施傳輸到遠端時遺失的封包數目。值會每分鐘傳送一次，直到通話結束為止。值計數是累積的。 單位：計數
VcToRemoteJitter	從 Amazon Chime SDK 語音連接器基礎設施傳送到遠端封包的平均抖動。 單位：微秒
RTTBetweenVcAndRemote	遠端端和 Amazon Chime SDK 語音連接器基礎設施之間的平均往返時間。 單位：微秒
MOSBetweenVcAndRemote	與遠端和 Amazon Chime SDK 語音連接器基礎設施之間的語音串流相關聯的估計平均意見分數 (MOS)。 單位：單位：介於 1.0-4.4 之間的分數。分數越高，表示感知的音訊品質越好。

CloudWatch Amazon Chime 聲 SDK 的維度

您可以搭配 Amazon Chime 開發套件使用的 CloudWatch 維度如下所示。

維度	描述
VoiceConnectorId	用於顯示指標的 Amazon Chime SDK 語音連接器的識別碼。
Region	與事件相關聯的 AWS 地區。

CloudWatch Amazon Chime 聲開發套件的日誌

您可以設定 Amazon Chime SDK 語音連接器，將指標傳送到 CloudWatch 日誌。當您這麼做時，您也可以接收這些語音連接器的媒體品質指標記錄。

Amazon Chime SDK 會每分鐘傳送一次詳細指標。Amazon Chime SDK 會針對使用設定的語音連接器進行的所有呼叫傳送這些通話，然後將它們傳送到我們為您建立的 CloudWatch 日誌記錄群組。

記錄群組名稱使用以下格式：/aws/ChimeVoiceConnectorLogs/${VoiceConnectorID}。

如需設定語音連接器以傳送量度的相關資訊，請參閱編輯 Amazon Chime 聲 SDK 語音連接器設定。

注意

封包遺失指標會在通話期間累積。例如，如果封包遺失發生在 11:01，則該遺失值會在通話的剩餘分鐘內結轉。在通話結束時，您會收到單一封包遺失量度。

Amazon Chime 開發套件在日誌中包含以下 JSON 格式的欄位。

欄位	描述
voice_connector_id	傳送呼叫的 Amazon Chime SDK 語音連接器識別碼。
event_timestamp	發出指標的時間，單位為自 UNIX Epoch (1970 年 1 月 1 日午夜) 以來的毫秒數 (UTC)。
call_id	對應至「交易 ID」。
from_sip_user	呼叫的起始使用者。
from_country	呼叫的起始國家/地區。
to_sip_user	呼叫的接收使用者。
to_country	呼叫的接收國家/地區。
endpoint_id	指示呼叫的其他端點的不透明識別符。搭配 CloudWatch 日誌見解使用。如需詳細資訊，請參閱 Amazon CloudWatch 日誌使用者指南中的使用日誌洞察分析 CloudWatch 日誌資料。
aws_region	通話的 AWS 地區。
cust2vc_rtp_packets	從客戶傳送至 Amazon Chime SDK 語音連接器基礎設施的 RTP 封包數目。
cust2vc_rtp_bytes	從客戶傳送至 Amazon Chime SDK 語音連接器基礎設施的位元組數 (以 RTP 封包為單位)。
cust2vc_rtcp_packets	從客戶傳送至 Amazon Chime SDK 語音連接器基礎設施的 RTCP 封包數目。
cust2vc_rtcp_bytes	客戶傳送至 Amazon Chime SDK 語音連接器基礎設施的位元組數 (以 RTCP 封包為單位)。
cust2vc_packets_lost	從客戶傳輸到 Amazon Chime SDK 語音連接器基礎設施時遺失的封包數目。值會每分鐘傳送一次，直到通話結束為止。值計數是累積的。
cust2vc_jitter	從客戶傳送至 Amazon Chime SDK 語音連接器基礎設施的封包平均抖動。
vc2cust_rtp_packets	從 Amazon Chime SDK 語音連接器基礎設施傳送給客戶的 RTP 封包數目。
vc2cust_rtp_bytes	從 Amazon Chime SDK 語音連接器基礎設施傳送給客戶的位元組數 (以 RTP 封包為單位)。
vc2cust_rtcp_packets	從 Amazon Chime SDK 語音連接器基礎設施傳送給客戶的 RTCP 封包數目。
vc2cust_rtcp_bytes	從 Amazon Chime SDK 語音連接器基礎設施傳送給客戶的位元組數 (以 RTCP 封包為單位)。
vc2cust_packets_lost	從 Amazon Chime SDK 語音連接器基礎設施傳輸至客戶的封包數目。值會每分鐘傳送一次，直到通話結束為止。值計數是累積的。
vc2cust_jitter	從 Amazon Chime SDK 語音連接器基礎設施傳送給客戶的封包的平均抖動。
rtt_btwn_vc_and_cust	客戶與 Amazon Chime SDK 語音連接器基礎設施之間的平均往返時間。
mos_btwn_vc_and_cust	與客戶和 Amazon Chime SDK 語音連接器基礎設施之間的語音串流相關聯的預估平均意見分數 (MOS)。
rem2vc_rtp_packets	從遠端傳送到 Amazon Chime SDK 語音連接器基礎設施的 RTP 封包數目。
rem2vc_rtp_bytes	從遠端傳送至 Amazon Chime SDK 語音連接器基礎設施的位元組數 (以 RTP 封包為單位)。
rem2vc_rtcp_packets	從遠端傳送到 Amazon Chime SDK 語音連接器基礎設施的 RTCP 封包數目。
rem2vc_rtcp_bytes	從遠端傳送至 Amazon Chime SDK 語音連接器基礎設施的位元組數 (以 RTCP 封包為單位)。
rem2vc_packets_lost	從遠端傳輸到 Amazon Chime SDK 語音連接器基礎設施的傳輸中遺失的封包數目。值會每分鐘傳送一次，直到通話結束為止。值計數是累積的。
rem2vc_jitter	從遠端傳送到 Amazon Chime SDK 語音連接器基礎設施的封包平均抖動。
vc2rem_rtp_packets	從 Amazon Chime SDK 語音連接器基礎設施傳送到遠端的 RTP 封包數目。
vc2rem_rtp_bytes	從 Amazon Chime SDK 語音連接器基礎設施傳送到遠端的位元組數 (以 RTP 封包為單位)。
vc2rem_rtcp_packets	從 Amazon Chime SDK 語音連接器基礎設施傳送到遠端的 RTCP 封包數目。
vc2rem_rtcp_bytes	從 Amazon Chime SDK 語音連接器基礎設施傳送到遠端的位元組數 (以 RTCP 封包為單位)。
vc2rem_packets_lost	從 Amazon Chime SDK 語音連接器基礎設施傳輸到遠端時遺失的封包數目。值會每分鐘傳送一次，直到通話結束為止。值計數是累積的。
vc2rem_jitter	從 Amazon Chime SDK 語音連接器基礎設施傳送到遠端封包的平均抖動。
rtt_btwn_vc_and_rem	遠端端和 Amazon Chime SDK 語音連接器基礎設施之間的平均往返時間。
mos_btwn_vc_and_rem	與遠端和 Amazon Chime SDK 語音連接器基礎設施之間的語音串流相關聯的估計平均意見分數 (MOS)。

SIP 訊息日誌

您可以選擇接收 Amazon Chime SDK 語音連接器的 SIP 訊息日誌。當您這麼做時，Amazon Chime SDK 會擷取輸入和輸出 SIP 訊息，並將它們傳送到為您建立的 CloudWatch 日誌記錄群組。日誌群組的名稱為 /aws/ChimeVoiceConnectorSipMessages/${VoiceConnectorID}。日誌中會包含以下欄位，其格式為 JSON。

欄位	描述
voice_connector_id	Amazon Chime 聲 SDK 語音連接器 ID。
aws_region	與事件相關聯的 AWS 地區。
event_timestamp	擷取訊息的時間，單位為自 UNIX Epoch (1970 年 1 月 1 日午夜) 以來的毫秒數 (UTC)。
call_id	Amazon Chime 聲 SDK 語音連接器呼叫識別碼。
sip_message	擷取的完整 SIP 訊息。