使用 Amazon CloudWatch 監控 Amazon Chime SDK - Amazon Chime SDK
Amazon Chime SDK 的 CloudWatch 指標Amazon Chime SDK 的 CloudWatch 維度Amazon Chime SDK 的 CloudWatch 日誌

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Amazon CloudWatch 監控 Amazon Chime SDK

您可以使用 CloudWatch 來監控 Amazon Chime SDK。CloudWatch 可收集原始資料，將這些資料轉換為可讀取且幾近即時的指標。這些統計資料會保留 15 個月，以便您可以存取歷史資訊，並更清楚地了解 Web 應用程式或服務的效能。您也可以設定留意特定閾值的警示，當滿足這些閾值時傳送通知或採取動作。如需詳細資訊，請參閱 Amazon CloudWatch 使用者指南。

Amazon Chime SDK 的 CloudWatch 指標

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

AWS/ChimeVoiceConnector 命名空間包含下列指派給您 AWS 帳戶和 Amazon Chime SDK Voice Connectors 的電話號碼指標。

注意

軟體開發套件會在通話期間每分鐘傳送封包遺失值一次。損失值會在呼叫期間累積。例如，如果封包在 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 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 基礎設施時遺失的封包數量。每分鐘都會傳送值，直到呼叫結束為止。值計數是累加的。

單位：計數

CustomerToVcJitter

從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施的封包平均抖動。

單位：微秒

VcToCustomerRtpPackets

從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的 RTP 封包數量。

單位：計數

VcToCustomerRtpBytes

從 Amazon Chime SDK Voice Connector 基礎設施傳送至 RTP 封包中客戶的位元組數。

單位：計數

VcToCustomerRtcpPackets

從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的 RTCP 封包數量。

單位：計數

VcToCustomerRtcpBytes

從 Amazon Chime SDK Voice Connector 基礎設施傳送至 RTCP 封包中客戶的位元組數。

單位：計數

VcToCustomerPacketsLost

從 Amazon Chime SDK Voice Connector 基礎設施傳輸到客戶的遺失封包數量。每分鐘都會傳送值，直到呼叫結束為止。值計數是累加的。

單位：計數

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 基礎設施時遺失的封包數量。每分鐘都會傳送值，直到呼叫結束為止。值計數是累加的。

單位：計數

RemoteToVcJitter

從遠端傳送至 Amazon Chime SDK Voice Connector 基礎設施之封包的平均抖動。

單位：微秒

VcToRemoteRtpPackets

從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的 RTP 封包數量。

單位：計數

VcToRemoteRtpBytes

從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的位元組數，以 RTP 封包顯示。

單位：計數

VcToRemoteRtcpPackets

從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的 RTCP 封包數量。

單位：計數

VcToRemoteRtcpBytes

從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的位元組數，以 RTCP 封包顯示。

單位：計數

VcToRemotePacketsLost

從 Amazon Chime SDK Voice Connector 基礎設施傳輸到遠端時遺失的封包數量。每分鐘都會傳送值，直到呼叫結束為止。值計數是累加的。

單位：計數

VcToRemoteJitter

從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端之封包的平均抖動。

單位：微秒

RTTBetweenVcAndRemote

遠端與 Amazon Chime SDK Voice Connector 基礎設施之間的平均往返時間。

單位：微秒

MOSBetweenVcAndRemote

遠端與 Amazon Chime SDK Voice Connector 基礎設施之間與語音串流相關聯的預估平均意見分數 (MOS)。

單位：單位：介於 1.0-4.4 之間的分數。分數越高，表示感知的音訊品質越好。

Amazon Chime SDK 的 CloudWatch 維度

您可以與 Amazon Chime SDK 搭配使用的 CloudWatch 維度如下所示。

維度 描述

VoiceConnectorId

要顯示指標的 Amazon Chime SDK Voice Connector 識別符。

Region

與事件相關聯的 AWS 區域。

Amazon Chime SDK 的 CloudWatch 日誌

您可以設定 Amazon Chime SDK Voice Connectors 將指標傳送至 CloudWatch Logs。執行此作業時，您也可以接收這些 Voice Connectors 的媒體品質指標日誌。

Amazon Chime SDK 每分鐘傳送一次詳細指標。Amazon Chime SDK 會針對使用已設定語音連接器進行的所有呼叫傳送它們，並將其傳送至我們為您建立的 CloudWatch Logs 日誌群組。

日誌群組名稱使用此格式：/aws/ChimeVoiceConnectorLogs/${VoiceConnectorID}。

如需設定 Voice Connectors 以傳送指標的詳細資訊，請參閱 編輯 Amazon Chime SDK Voice Connector 設定。

注意

封包遺失指標會在呼叫期間累積。例如，如果封包在 11：01 發生遺失，該遺失值會轉送至剩餘的通話分鐘。在通話結束時，您會收到單一封包遺失指標。

Amazon Chime SDK 在日誌中包含下列欄位，格式為 JSON。

欄位 描述

voice_connector_id

承載呼叫的 Amazon Chime SDK Voice Connector ID。

event_timestamp

發出指標的時間，單位為自 UNIX Epoch (1970 年 1 月 1 日午夜) 以來的毫秒數 (UTC)。

call_id

對應至交易 ID。

from_sip_user

呼叫的起始使用者。

from_country

呼叫的起始國家/地區。

to_sip_user

呼叫的接收使用者。

to_country

呼叫的接收國家/地區。

endpoint_id

指示呼叫的其他端點的不透明識別符。搭配 CloudWatch Logs Insights 使用。如需詳細資訊，請參閱《Amazon CloudWatch Logs 使用者指南》中的使用 CloudWatch Logs Insights 分析日誌資料。 Amazon CloudWatch

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 基礎設施時遺失的封包數量。每分鐘都會傳送值，直到呼叫結束為止。值計數是累加的。

cust2vc_jitter

從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施的封包平均抖動。

vc2cust_rtp_packets

從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的 RTP 封包數量。

vc2cust_rtp_bytes

從 Amazon Chime SDK Voice Connector 基礎設施傳送至 RTP 封包中客戶的位元組數。

vc2cust_rtcp_packets

從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的 RTCP 封包數量。

vc2cust_rtcp_bytes

從 Amazon Chime SDK Voice Connector 基礎設施傳送至 RTCP 封包中客戶的位元組數。

vc2cust_packets_lost

從 Amazon Chime SDK Voice Connector 基礎設施傳輸到客戶的遺失封包數量。每分鐘都會傳送值，直到呼叫結束為止。值計數是累加的。

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 基礎設施時遺失的封包數量。每分鐘都會傳送值，直到呼叫結束為止。值計數是累加的。

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 基礎設施傳輸到遠端時遺失的封包數量。每分鐘都會傳送值，直到呼叫結束為止。值計數是累加的。

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 Voice Connector 的 SIP 訊息日誌。當您執行此作業時，Amazon Chime SDK 會擷取傳入和傳出 SIP 訊息，並將其傳送至為您建立的 CloudWatch Logs 日誌群組。日誌群組的名稱為 /aws/ChimeVoiceConnectorSipMessages/${VoiceConnectorID}。日誌中會包含以下欄位，其格式為 JSON。

欄位 描述

voice_connector_id

Amazon Chime SDK Voice Connector ID。

aws_region

與事件相關聯的 AWS 區域。

event_timestamp

擷取訊息的時間，單位為自 UNIX Epoch (1970 年 1 月 1 日午夜) 以來的毫秒數 (UTC)。

call_id

Amazon Chime SDK Voice Connector 呼叫 ID。

sip_message

擷取的完整 SIP 訊息。