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

# 使用 Amazon CloudWatch 監控 Amazon Chime SDK
<a name="monitoring-cloudwatch"></a>

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

**注意**  
軟體開發套件會在呼叫期間每分鐘傳送封包遺失值一次。損失值會在呼叫期間累積。例如，如果封包在 11：01 發生遺失，該遺失值會轉送至通話的剩餘分鐘數。在通話結束時，您會收到單一封包遺失指標。


| 指標 | Description | 
| --- | --- | 
| `SmaActiveCallCount` | 作用中並行 Sip Media Application 呼叫的數量。<br />單位：Count | 
| `VoiceConnectorActiveCallCount` | 作用中並行語音連接器呼叫的數量。<br />單位：Count | 
| `InboundCallAttempts` | 嘗試的傳入呼叫次數。<br />單位：Count | 
| `InboundCallFailures` | 傳入呼叫的失敗次數。<br />單位：Count | 
| `InboundCallsAnswered` | 接聽的傳入呼叫數。<br />單位：Count | 
| `InboundCallsActive` | 目前作用中的傳入呼叫數。<br />單位：Count | 
| `OutboundCallAttempts` | 嘗試的傳出呼叫數。<br />單位：Count | 
| `OutboundCallFailures` | 傳出呼叫的失敗次數。<br />單位：Count | 
| `OutboundCallsAnswered` | 接聽的傳出呼叫數。<br />單位：Count | 
| `OutboundCallsActive` | 目前作用中的傳出呼叫數。<br />單位：Count | 
| `Throttles` | 嘗試進行呼叫時，您帳戶受到節流的次數。<br />單位：Count | 
| `Sip1xxCodes` | 狀態代碼為 1xx 層級的 SIP 訊息數。<br />單位：Count | 
| `Sip2xxCodes` | 狀態代碼為 2xx 層級的 SIP 訊息數。<br />單位：Count | 
| `Sip3xxCodes` | 狀態代碼為 3xx 層級的 SIP 訊息數。<br />單位：Count | 
| `Sip4xxCodes` | 狀態代碼為 4xx 層級的 SIP 訊息數。<br />單位：Count | 
| `Sip5xxCodes` | 狀態代碼為 5xx 層級的 SIP 訊息數。<br />單位：Count | 
| `Sip6xxCodes` | 狀態代碼為 6xx 層級的 SIP 訊息數。<br />單位：Count | 
| `CustomerToVcRtpPackets` | 從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施的 RTP 封包數量。<br />單位：Count | 
| `CustomerToVcRtpBytes` | 從客戶傳送至 RTP 封包中 Amazon Chime SDK Voice Connector 基礎設施的位元組數。<br />單位：Count | 
| `CustomerToVcRtcpPackets` | 從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施的 RTCP 封包數量。<br />單位：Count | 
| `CustomerToVcRtcpBytes` | RTCP 封包中從客戶傳送至 Amazon Chime SDK Voice Connector 基礎設施的位元組數。<br />單位：Count | 
| `CustomerToVcPacketsLost` | 從客戶到 Amazon Chime SDK Voice Connector 基礎設施的傳輸中遺失封包數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。<br />單位：Count | 
| `CustomerToVcJitter` | 從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施之封包的平均抖動。<br />單位：微秒 | 
| `VcToCustomerRtpPackets` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的 RTP 封包數量。<br />單位：Count | 
| `VcToCustomerRtpBytes` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的位元組數，以 RTP 封包顯示。<br />單位：Count | 
| `VcToCustomerRtcpPackets` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的 RTCP 封包數量。<br />單位：Count | 
| `VcToCustomerRtcpBytes` | RTCP 封包中從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的位元組數。<br />單位：Count | 
| `VcToCustomerPacketsLost` | 從 Amazon Chime SDK Voice Connector 基礎設施傳輸到客戶的封包遺失數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。<br />單位：Count | 
| `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 />單位：Count | 
| `RemoteToVcRtpBytes` | 從遠端傳送至 RTP 封包中 Amazon Chime SDK Voice Connector 基礎設施的位元組數。<br />單位：Count | 
| `RemoteToVcRtcpPackets` | 從遠端傳送至 Amazon Chime SDK Voice Connector 基礎設施的 RTCP 封包數量。<br />單位：Count | 
| `RemoteToVcRtcpBytes` | 從遠端傳送至 RTCP 封包中 Amazon Chime SDK Voice Connector 基礎設施的位元組數。<br />單位：Count | 
| `RemoteToVcPacketsLost` | 從遠端傳輸到 Amazon Chime SDK Voice Connector 基礎設施時遺失的封包數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。<br />單位：Count | 
| `RemoteToVcJitter` | 從遠端傳送至 Amazon Chime SDK Voice Connector 基礎設施之封包的平均抖動。<br />單位：微秒 | 
| `VcToRemoteRtpPackets` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的 RTP 封包數量。<br />單位：Count | 
| `VcToRemoteRtpBytes` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的位元組數，以 RTP 封包顯示。<br />單位：Count | 
| `VcToRemoteRtcpPackets` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的 RTCP 封包數量。<br />單位：Count | 
| `VcToRemoteRtcpBytes` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的位元組數，以 RTCP 封包顯示。<br />單位：Count | 
| `VcToRemotePacketsLost` | 從 Amazon Chime SDK Voice Connector 基礎設施到遠端傳輸中遺失的封包數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。<br />單位：Count | 
| `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 維度如下所示。


| 維度 | Description | 
| --- | --- | 
| `VoiceConnectorId` | 要顯示指標的 Amazon Chime SDK Voice Connector 識別符。 | 
| `Region` | 與事件相關聯的 AWS 區域。 | 

## Amazon Chime SDK 的 CloudWatch 日誌
<a name="cw-logs"></a>

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

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

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

如需設定語音連接器以傳送指標的詳細資訊，請參閱 [編輯 Amazon Chime SDK Voice Connector 設定](edit-voicecon.md)。

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

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


| 欄位 | Description | 
| --- | --- | 
| 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 分析日誌資料](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 基礎設施的傳輸中遺失封包數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。 | 
| 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 | RTCP 封包中從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的位元組數。 | 
| 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。


| 欄位 | Description | 
| --- | --- | 
| 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 訊息。 |