

# 监控 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. 在**浏览**选项卡上，使用左侧未标记的下拉菜单，选择您的“主”区域，即创建通道的区域。有关区域的详细信息，请参阅[全球解决方案，区域控制](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/what-is.html#what-is-aws)。有关支持区域的列表，请参阅[亚马逊云科技一般参考](https://docs.aws.amazon.com/general/latest/gr/ivs.html)中的 *Amazon IVS* 页面。

1. 在**浏览**选项卡的底部，选择 **IVSChat** 命名空间。

1. 请执行以下操作之一：

   1. 在搜索栏中，输入资源 ID（是 ARN `arn:::ivschat:room/<resource id>` 的一部分）。

      然后选择 **IVSChat**。

   1. 如果 **IVSChat** 显示为 **Amazon 命名空间**下的一个可选服务，选择该服务。如果您使用 Amazon IVSChat 并将指标发送给 Amazon CloudWatch，则将会列出 IVSChat。（如果 **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>

您也可以使用 Amazon CLI 访问指标。这需要首先在计算机上下载并配置 CLI。有关详细信息，请参阅 [Amazon 命令行界面用户指南](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 Chat 在 **Amazon/IVSChat** 命名空间中提供以下指标。


| 指标 | Dimensions | 说明 | 
| --- | --- | --- | 
|  `ConcurrentChatConnections`  | 无 |  聊天室中的并发连接总数（每分钟报告的最大连接数）。这有助于了解客户何时接近区域中的并发聊天连接限制。 单位：个 有效统计数据：总数、平均值、最大值、最小值  | 
|  `Deliveries`  | Action |  由特定操作类型向某个区域中所有房间的聊天连接发送的消息请求数。 单位：个 有效统计数据：总数、平均值、最大值、最小值  | 
|  `InvocationErrors`  | `Uri` |  某个区域中所有房间的特定消息审核处理程序的调用错误数。无法调用消息审核处理程序时，会出现调用错误。 当 Amazon IVS Chat 无法调用处理程序时，会出现调用错误。如果与房间关联的处理程序不再存在或超时，或者其资源策略不允许服务对其进行调用，则可能会发生这种情况。 单位：个 有效统计数据：总数、平均值、最大值、最小值  | 
|  `LogDestinationAccessDeniedError`  | `LoggingConfiguration` |  日志目标在某个区域内所有房间的拒绝访问错误数。 当 Amazon IVS Chat 无法访问您在日志记录配置中指定的目标资源时，会出现这些错误。如果目标资源策略不允许服务放置记录，则可能会发生这种情况。 单位：个 有效统计数据：总数、平均值、最大值、最小值  | 
|  `LogDestinationErrors`  | `LoggingConfiguration` |  日志目标在某个区域内所有房间的所有错误数。 这是一个聚合指标，包括当 Amazon IVS Chat 无法将日志传送到您在日志记录配置中指定的目标资源时发生的所有类型的错误。 单位：个 有效统计数据：总数、平均值、最大值、最小值  | 
|  `LogDestinationResourceNotFoundErrors`  | `LoggingConfiguration` |  日志目标在某个区域内所有房间的“找不到资源”错误数。 当 Amazon IVS Chat 因为资源不存在而无法将日志传送到您在日志记录配置中指定的目标资源时，会出现这些错误。如果与日志记录配置相关联的目标资源不再存在，则可能会发生这种情况。 单位：个 有效统计数据：总数、平均值、最大值、最小值  | 
|  `MessagingDeliveries`  | 无 |  向某个区域中所有房间的聊天连接发送的消息请求数。 单位：个 有效统计数据：总数、平均值、最大值、最小值  | 
|  `MessagingRequests`  | 无 |  某个区域中所有房间发出的消息请求数。 单位：个 有效统计数据：总数、平均值、最大值、最小值  | 
|  `Requests`  | Action | 某个区域中所有房间由特定操作类型发出的请求数。 单位：个 有效统计数据：总数、平均值、最大值、最小值  | 
|  `ResponseValidationErrors`  | `Uri` |  某个区域中所有房间的特定消息审核处理程序的响应验证错误数。当消息审核处理程序的响应无效时，会出现响应验证错误。这可能意味着无法解析响应或验证检查失败；例如，审核结果无效或响应值过长。 单位：个 有效统计数据：总数、平均值、最大值、最小值  | 