# 監控 Amazon IVS 聊天功能
<a name="chat-health"></a>

您可以使用 Amazon CloudWatch 監控 Amazon Interactive Video Service (IVS) 聊天功能資源。CloudWatch 可收集並處理來自 Amazon IVS 聊天功能的原始資料，進而將這些資料轉換為便於讀取且幾近即時的指標。這些統計資料會保留 15 個月，以便您了解 Web 應用程式或服務效能的歷史。您可以設定特定閾值的警示，當滿足這些閾值時傳送通知或採取動作。如需詳細資訊，請參閱 [CloudWatch 使用者指南](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)。

## 存取 CloudWatch 指標
<a name="chat-health-cloudwatch-metrics"></a>

Amazon CloudWatch 可收集並處理來自 Amazon IVS 聊天功能的原始資料，進而將這些資料轉換為可讀取且幾近即時的指標。這些統計資料會保留 15 個月，以便您了解 Web 應用程式或服務效能的歷史。您可以設定特定閾值的警示，當滿足這些閾值時傳送通知或採取動作。如需詳細資訊，請參閱 [CloudWatch 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)。

請注意，CloudWatch 指標會隨著時間累計。隨著指標的時間變長，解析度會有效降低。排程如下：
+ 60 秒的指標可供使用 15 天。
+ 5 分鐘的指標可供使用 63 天。
+ 1 小時的指標可供使用 455 天 (15 個月)。

如需有關資料保留的最新資訊，請在 [Amazon CloudWatch 常見問答集](https://aws.amazon.com/cloudwatch/faqs/)中搜尋「保留期間」。

### CloudWatch 主控台說明
<a name="chat-health-cloudwatch-metrics-console"></a>

1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在側邊導覽中，展開 **Metrics** (指標) 下拉式選單，然後選取 **All metrics** (所有指標)。

1. 在 **Browse** (瀏覽)索引標籤上，使用左側無標籤的下拉式清單，選取建立頻道的「主要」區域。有關區域的更多資訊，請參閱[全球解決方案、區域控制](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/what-is.html#what-is-aws)。如需支援的區域清單，請參閱 *AWS 一般參考*中的 [Amazon IVS 頁面](https://docs.aws.amazon.com/general/latest/gr/ivs.html)。

1. 在**瀏覽**索引標籤底部，選取 **IVSChat** 命名空間。

1. 執行以下任意一項：

   1. 在搜尋列中，輸入您的資源 ID (ARN 的一部分，`arn:::ivschat:room/<resource id>`)。

      然後選取 **IVSChat**。

   1. 如果 **IVSChat** 在 **AWS 命名空間**下顯示為可選取的服務，則請選取它。如果您使用 Amazon IVSChat 並且其正在傳送指標到 Amazon CloudWatch，則會將其列出。(如果未列出 **IVSChat**，則您沒有任何 Amazon IVSChat 指標。)

      然後根據需要選擇*維度*分組；可用的維度會列在下方的 [CloudWatch 指標](#chat-health-cloudwatch-metrics-chat)。

1. 選擇要新增到圖表的指標。可用的指標列在 [CloudWatch 的指標](#chat-health-cloudwatch-metrics-chat)。

您也可以選取**在 CloudWatch 中檢視**按鈕，從聊天工作階段的詳細資訊頁面存取聊天工作階段的 CloudWatch 圖表。

### CLI 說明
<a name="chat-health-cloudwatch-metrics-cli"></a>

您也可以使用 AWS CLI 存取指標。這需要在您的機器上先下載並設定 CLI。如需詳細資訊，請參閱 [AWS 命令列界面使用者指南](https://docs.aws.amazon.com//cli/latest/userguide/cli-chap-welcome.html)。

然後，使用 AWS CLI 存取 Amazon IVS 低延遲聊天功能指標：
+ 在命令提示中，執行：

  ```
  aws cloudwatch list-metrics --namespace AWS/IVSChat
  ```

如需詳細資訊，請參閱 *Amazon CloudWatch 使用者指南*中的[使用 Amazon CloudWatch 指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)。

## CloudWatch 指標：IVS 聊天功能
<a name="chat-health-cloudwatch-metrics-chat"></a>

Amazon IVS 聊天功能在 **AWS/IVSChat** 命名空間中提供以下指標。


| 指標 | 維度 | Description | 
| --- | --- | --- | 
| `ConcurrentChatConnections` | 無 | 聊天室中的並行連線總數 (每分鐘報告的最大值)。這有助於了解一個區域中的客戶何時接近並行聊天連線數上限。<br />單位：計數<br />有效統計資訊：總和、平均數、上限、下限 | 
| `Deliveries` | 動作 | 向一個區域中所有聊天室的聊天連線傳送特定動作類型的訊息請求次數。<br />單位：計數<br />有效統計資訊：總和、平均數、上限、下限 | 
| `InvocationErrors` | `Uri` | 一個區域中所有聊天室的特定訊息審查處理常式的叫用錯誤數。無法叫用訊息審查處理常式時會發生叫用錯誤。<br />當 Amazon IVS 聊天功能無法叫用處理常式時，會發生叫用錯誤。如果與聊天室關聯的處理常式不再存在或逾時，或者如果資源政策不允許服務叫用它，則會發生這種情況。<br />單位：計數<br />有效統計資訊：總和、平均數、上限、下限 | 
| `LogDestinationAccessDeniedError` | `LoggingConfiguration` | 區域中所有聊天室的日誌目的地拒絕存取錯誤數量。<br />當 Amazon IVS 聊天功能無法存取您在記錄組態中指定的目的地資源時，即會發生這些錯誤。如果目的地資源政策不允許服務放置記錄，則可能會發生這種情況。<br />單位：計數<br />有效統計資訊：總和、平均數、上限、下限 | 
| `LogDestinationErrors` | `LoggingConfiguration` | 區域中所有聊天室的日誌目的地所有錯誤數量。<br />這是一個彙總指標，其中包括 Amazon IVS 聊天功能無法將日誌傳遞至您在記錄組態中指定的目的地資源時發生的所有錯誤類型。<br />單位：計數<br />有效統計資訊：總和、平均數、上限、下限 | 
| `LogDestinationResourceNotFoundErrors` | `LoggingConfiguration` | 區域中所有聊天室的日誌目的地找不到資源錯誤數量。<br />當 Amazon IVS 聊天功能因為資源不存在而無法將日誌傳遞至您在記錄組態中指定的目的地資源時，即會發生這些錯誤。如果與記錄組態相關聯的目的地資源不再存在，即可能會發生這種情況。<br />單位：計數<br />有效統計資訊：總和、平均數、上限、下限 | 
| `MessagingDeliveries` | 無 | 向一個區域中所有聊天室的聊天連線傳送訊息請求的次數。<br />單位：計數<br />有效統計資訊：總和、平均數、上限、下限 | 
| `MessagingRequests` | 無 | 一個區域的所有聊天室發出的訊息請求數。<br />單位：計數<br />有效統計資訊：總和、平均數、上限、下限 | 
| `Requests` | 動作 | 一個區域的所有聊天室中針對特定動作類型提出的請求數。<br />單位：計數<br />有效統計資訊：總和、平均數、上限、下限 | 
| `ResponseValidationErrors` | `Uri` | 一個區域中所有聊天室的特定訊息審查處理常式的回應驗證錯誤數。當訊息審查處理常式的回應無效時，會發生回應驗證錯誤。這可能意味著無法解析回應或驗證檢查失敗；例如，無效的審查結果或過長的回應值。<br />單位：計數<br />有效統計資訊：總和、平均數、上限、下限 |