本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用亚马逊监控亚马逊密钥空间 CloudWatch
<a name="monitoring-cloudwatch"></a>

您可以使用 Amazon 监控 Amazon Keyspaces CloudWatch，亚马逊会收集原始数据并将其处理为可读的近乎实时的指标。这些统计数据会保存 15 个月，从而使您能够访问历史信息，并能够更好地了解您的 Web 应用程序或服务的执行情况。

此外，可以设置用于监测特定阈值的警报，并在达到相应阈值时发送通知或执行操作。有关更多信息，请参阅 [Amazon CloudWatch 用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。

**注意**  
要快速开始使用显示 Amazon Keyspaces 常用指标的预配置 CloudWatch 控制面板，您可以使用提供的 CloudFormation 模板。[https://github.com/aws-samples/amazon-keyspaces-cloudwatch-cloudformation-templates](https://github.com/aws-samples/amazon-keyspaces-cloudwatch-cloudformation-templates)

**Topics**
+ [如何使用 Amazon Keyspaces 指标？](#how-to-use-metrics)
+ [Amazon Keyspaces 指标与维度](metrics-dimensions.md)
+ [在中查看 Amazon Keyspaces 指标 CloudWatch](view-metrics.md)
+ [创建 CloudWatch 警报以监控 Amazon Keyspaces](creating-alarms.md)

## 如何使用 Amazon Keyspaces 指标？
<a name="how-to-use-metrics"></a>

Amazon Keyspaces 报告的指标为您提供了可通过不同方式分析的信息。下面的列表显示这些指标的一些常见用途。这些是入门建议，并不全面。有关指标和保留的更多信息，请参阅 [Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric)。


****  

|  我如何？  |  相关指标  | 
| --- | --- | 
|  如何确定是否发生了任何系统错误？  |  您可以监控 `SystemErrors`，以确定是否有任何请求导致了服务器错误代码。通常，此指标应等于零。如果不是，您可能需要调查。  | 
|  如何比较平均预置读取容量与使用的读取容量？  |  监控平均预置读取容量和使用的读取容量 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/monitoring-cloudwatch.html) 现在，您可以将使用的平均读取容量与预置容量进行比较。有关基本算术函数以及如何创建时间序列的更多信息，请参阅 [Using metric math](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html)。  | 
|  如何比较平均预置写入容量与使用的写入容量？  |  监控平均预置写入容量和使用的写入容量 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/monitoring-cloudwatch.html) 现在，您可以将使用的平均写入容量与预置容量进行比较。有关基本算术函数以及如何创建时间序列的更多信息，请参阅 [Using metric math](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html)。  | 

# Amazon Keyspaces 指标与维度
<a name="metrics-dimensions"></a>

当您与 Amazon Keyspaces 互动时，它会向亚马逊发送指标和维度。 CloudWatch所有指标每分钟汇总和报告一次。以下各节概述了 Amazon Keyspaces 的所有可用指标。

**Topics**
+ [Amazon Keyspaces 指标](#keyspaces-metrics-dimensions)
+ [Amazon Keyspaces 指标的维度](#keyspaces-metric-dimensions)
+ [Amazon Keyspaces 变更数据采集 (CDC) 的指标](#keyspaces-cdc-metrics)
+ [Amazon Keyspaces 变更数据捕获 (CDC) 指标的维度](#keyspaces-metric-dimensions-cdc)

## Amazon Keyspaces 指标
<a name="keyspaces-metrics-dimensions"></a>

亚马逊每 CloudWatch 隔一分钟汇总亚马逊密钥空间指标。

并非所有的统计数据，如 `Average` 或 `Sum`，都适用于每个指标。但是，所有这些值都可通过 Amazon Keyspaces 控制台、使用 CloudWatch 控制台获得 AWS CLI，或者 AWS SDKs 适用于所有指标。在下表中，每个度量都有一个适用于该度量的有效统计信息列表。


| 指标 | 描述 | 
| --- | --- | 
| AccountMaxTableLevelReads |  账户的表可以使用的最大读取容量单位数。对于按需表，此值将限制表可以使用的最大读取请求单位。 单位：`Count` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| AccountMaxTableLevelWrites |  账户的表可以使用的最大写入容量单位数。对于按需表，此值将限制表可以使用的最大写入请求单位。 单位：`Count` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| AccountProvisionedReadCapacityUtilization |  账户使用的预置读取容量单位百分比。 单位：`Percent` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| AccountProvisionedWriteCapacityUtilization |  账户使用的预置写入容量单位百分比。 单位：`Percent` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| BillableTableSizeInBytes |  可计费的表大小（以字节为单位）。它是表中所有行的编码大小的总和。该指标可帮助您跟踪一段时间内的表存储成本。 单位：`Bytes` 维度：`Keyspace, TableName` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| ConditionalCheckFailedRequests |  失败的轻量级事务 (LWT) 写入请求数。`INSERT`、`UPDATE` 和 `DELETE` 操作允许提供一个逻辑条件，该条件计算结果必须为 true，才能继续操作。如果此条件的计算结果为 false，则 `ConditionalCheckFailedRequests` 增加 1。评估结果为 false 的条件检查会根据行的大小消耗写入容量单位。有关更多信息，请参阅 [估算 Amazon Keyspaces 中轻量级事务的容量消耗](lightweight_transactions.md)。 单位：`Count` 维度：`Keyspace, TableName` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| ConsumedReadCapacityUnits |  在指定时间段内使用的读取容量单位数。有关更多信息，请参阅 [Read/Write capacity mode](https://docs.aws.amazon.com/keyspaces/latest/devguide/ReadWriteCapacityMode.html)。  要了解每秒平均吞吐量利用率，请使用 `Sum` 统计数据计算一分钟内消耗的吞吐量。然后，将和值除以每分钟秒数 (60) 来计算每秒的平均 `ConsumedReadCapacityUnits`（确认此平均值不会突出这一分钟内出现的任何大而短暂的读取活动峰值）。有关将使用的平均读取容量与预置读取容量进行比较的详细信息，请参阅 [如何使用 Amazon Keyspaces 指标？](monitoring-cloudwatch.md#how-to-use-metrics)。  单位：`Count` 维度：`Keyspace, TableName` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| ConsumedWriteCapacityUnits |  在指定时间段内使用的写入容量单位数。您可以检索表使用的总写入容量。有关更多信息，请参阅 [Read/Write capacity mode](https://docs.aws.amazon.com/keyspaces/latest/devguide/ReadWriteCapacityMode.html)。  要了解每秒平均吞吐量利用率，请使用 `Sum` 统计数据计算一分钟内消耗的吞吐量。然后，将和值除以每分钟秒数 (60) 来计算每秒的平均 `ConsumedWriteCapacityUnits`（确认此平均值不会突出这一分钟内出现的任何大而短暂的写入活动峰值）。有关将使用的平均写入容量与预置写入容量进行比较的详细信息，请参阅 [如何使用 Amazon Keyspaces 指标？](monitoring-cloudwatch.md#how-to-use-metrics)。  单位：`Count` 维度：`Keyspace, TableName` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| MaxProvisionedTableReadCapacityUtilization |  账户的最高预置读取表所使用的预置读取容量单位的百分比。 单位：`Percent` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| MaxProvisionedTableWriteCapacityUtilization |  账户的最高预置写入表所使用的预置写入容量的百分比。 单位：`Percent` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| PerConnectionRequestRateExceeded |  对 Amazon Keyspaces 的请求数超出每个连接请求速率的限额。与 Amazon Keyspaces 的每个客户端连接每秒最多可支持 3000 个 CQL 请求。客户端可以创建多个连接以增加吞吐量。 当您使用多区域复制时，每次复制的写入也会影响此配额。作为最佳实践，我们建议增加表的连接数以避免 `PerConnectionRequestRateExceeded` 错误。对您在 Amazon Keyspaces 中可拥有的连接数没有限制。 单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| ProvisionedReadCapacityUnits |  表的预置读取容量单位数。 `TableName` 维度返回表的 `ProvisionedReadCapacityUnits`。 单位：`Count` 维度：`Keyspace, TableName` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| ProvisionedWriteCapacityUnits |  表的预置写入容量单位数。 `TableName` 维度返回表的 `ProvisionedWriteCapacityUnits`。 单位：`Count` 维度：`Keyspace, TableName` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| ReadThrottleEvents |  对 Amazon Keyspaces 的请求数超出表的预置读取容量、或账户级别限额、每个连接的请求限额或分区级别限额。 单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| ReplicationLatency |  该指标仅适用于多区域键空间，并且可用于衡量将 `updates`、`inserts` 或 `deletes` 从一个副本表复制到多区域键空间中的另一副本表所花费的时间。 单位：`Millisecond` 维度：`TableName, ReceivingRegion` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| ReturnedItemCountBySelect |  指定时间段内多行 `SELECT` 查询返回的行数。多行 `SELECT` 查询是不包含完全限定主键的查询，例如全表扫描和范围查询。 *返回的* 行数并不一定与已计算的行数相同。例如，假设您请求对一个具有 100 行的表执行具有 `ALLOW FILTERING` 的 `SELECT *`，但指定 `WHERE` 子句来缩小结果范围，以便仅返回 15 行。在此情况下，来自 `SELECT` 的响应包含的 `ScanCount` 为 100，`Count` 为返回的 15 行。 单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| StoragePartitionThroughputCapacityExceeded |  对 Amazon Keyspaces 存储分区的请求数超过了该分区的吞吐容量。Amazon Keyspaces 存储分区最多可以支持每秒 1000 个， WCU/WRU 每秒 3000 RCU/RRU 个。我们建议您检查您的数据模型，将 read/write 流量分配到更多分区，以缓解这些异常情况。  Amazon Keyspaces 逻辑分区可以跨越多个存储分区，并且大小几乎不受限制。  单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| SuccessfulRequestCount |  在指定时间段内成功处理的请求数。 单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| SuccessfulRequestLatency |  指定时间段内对 Amazon Keyspaces 的成功请求数。`SuccessfulRequestLatency` 可提供两种不同类型的信息： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html) `SuccessfulRequestLatency`仅反映 Amazon Keyspaces 内的活动，不考虑网络延迟或客户端活动。 单位：`Milliseconds` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| SystemErrors |  在指定时间段内生成 `ServerError` 的对 Amazon Keyspaces 的请求数。`ServerError` 通常指示内部服务错误。 单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| SystemReconciliationDeletes |  启用客户端时间戳时删除 Tombstoned 数据所使用的单位。每个 `SystemReconciliationDelete` 都提供足够的容量，可用于删除或更新每行最多 1 KB 的数据。例如，要更新一个存储了 2.5 KB 数据的行并同时删除该行内的一个或多个列，将需要 3 次 `SystemReconciliationDeletes`。或者，要删除一个包含 3.5 KB 数据的完整行，将需要 4 次 `SystemReconciliationDeletes`。 单位：`Count` 维度：`Keyspace, TableName` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| TTLDeletes |  使用生存时间 (TTL) 删除或更新一行数据所使用的单位。每个 `TTLDelete` 都提供足够的容量，可用于删除或更新每行最多 1 KB 的数据。例如，要更新一个存储了 2.5 KB 数据的行并同时删除该行内的一个或多个列，将需要 3 次 TTL 删除操作。或者，要删除一个包含 3.5 KB 数据的完整行，将需要 4 次 TTL 删除操作。 单位：`Count` 维度：`Keyspace, TableName` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| UserErrors |  在指定时间段内生成 `InvalidRequest` 错误的对 Amazon Keyspaces 的请求。 `InvalidRequest`错误通常代表客户端错误，例如参数组合无效、尝试更新不存在的表或请求签名不正确。 `UserErrors`表示当前请求 AWS 区域 和当前请求的无效请求的总和 AWS 账户。 单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| WriteThrottleEvents |  对 Amazon Keyspaces 的请求数超出表的预置写入容量、或账户级别限额、每个连接的请求限额或分区级别限额。  单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 

## Amazon Keyspaces 指标的维度
<a name="keyspaces-metric-dimensions"></a>

Amazon Keyspaces 的指标由账户、表名或操作的值进行限定。您可以使用 CloudWatch 控制台按下表中任意维度检索 Amazon Keyspaces 数据。


|  维度  |  描述  | 
| --- | --- | 
|  Keyspace  |  该维度将数据限定为特定键空间。该值可以是当前区域和当前 AWS 账户中的任意键空间。  | 
|  Operation  |  该维度将数据限定为 Amazon Keyspaces CQL 操作之一，如 `INSERT` 或 `SELECT` 操作。  | 
|  TableName  |  此维度将数据限制为特定表。该值可以是当前区域和当前 AWS 账户中的任意表名。如果表名称在账户中不是唯一的，则还必须指定 `Keyspace`。  | 

## Amazon Keyspaces 变更数据采集 (CDC) 的指标
<a name="keyspaces-cdc-metrics"></a>

您的 CloudWatch 账户中提供了以下指标，用于监控对 Amazon Keyspaces 更改数据捕获 (CDC) 终端节点的 API 调用。


| 指标 | 描述 | 
| --- | --- | 
| ReturnedRecordsCount |  在指定时间段内，`GetRecords`操作返回的流记录数。 单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| SuccessfulRequestLatency |  指定时间段内对 Amazon Keyspaces 的成功请求数。`SuccessfulRequestLatency` 可提供两种不同类型的信息： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html) `SuccessfulRequestLatency`仅反映 Amazon Keyspaces CDC APIs 内的活动，不考虑网络延迟或客户端活动。 单位：`Milliseconds` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| SystemErrors |  向 Amazon Keyspaces CDC 发出的在指定时间段内生成`HTTP 500`状态代码的请求。`HTTP 500`状态码通常表示内部服务错误。 单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 
| UserErrors |  向 Amazon Keyspaces CDC 发出的在指定时间段内生成`HTTP 400`状态代码的请求。 `UserErrors`表示 Amazon Keyspaces CDC 当前 AWS 区域 和当前`HTTP 400`错误的汇总。 AWS 账户 单位：`Count` 维度：`Keyspace, TableName, Operation` 有效统计数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/keyspaces/latest/devguide/metrics-dimensions.html)  | 

## Amazon Keyspaces 变更数据捕获 (CDC) 指标的维度
<a name="keyspaces-metric-dimensions-cdc"></a>

Amazon Keyspaces 的指标由账户、表名或操作的值进行限定。您可以使用 CloudWatch 控制台按下表中任意维度检索 Amazon Keyspaces 数据。


|  维度  |  描述  | 
| --- | --- | 
|  StreamLabel  |  当指定`KeyspaceName`和`TableName`时，此维度将数据限制为特定的变更数据捕获 (CDC) 流。  | 
|  Keyspace  |  该维度将数据限定为特定键空间。该值可以是当前区域和当前 AWS 账户中的任意键空间。  | 
|  TableName  |  此维度将数据限制为特定表。该值可以是当前区域和当前 AWS 账户中的任意表名。如果表名称在账户中不是唯一的，则还必须指定 `Keyspace`。  | 
|  Operation  |  此维度将数据限制为以下 Amazon Keyspaces Streams API 操作之一：`GetRecords``GetStream``GetShardIterator`、和。`ListStreams`  | 

# 在中查看 Amazon Keyspaces 指标 CloudWatch
<a name="view-metrics"></a>

当您与 Amazon Keyspaces 互动时，它会向亚马逊发送以下指标和维度。 CloudWatch所有指标每分钟汇总和报告一次。您可以使用以下流程查看 Amazon Keyspaces 的指标。

**使用 CloudWatch 控制台查看指标**

指标的分组首先依据服务命名空间，然后依据每个命名空间内的各种维度组合。

1. 打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。

1. 如果需要，更改 AWS 区域。在导航栏上，选择您的 AWS 资源所在的区域。有关更多信息，请参阅[AWS 服务端点](https://docs.aws.amazon.com/general/latest/gr/rande.html)。

1. 在导航窗格中，选择**指标**。

1. 在 **All metrics (全部指标)** 选项卡下，选择 `AWS/Cassandra.`。

**使用 AWS CLI 查看指标**
+ 在命令提示符处，使用以下命令。

  ```
  1. aws cloudwatch list-metrics --namespace "AWS/Cassandra"                        
  ```

# 创建 CloudWatch 警报以监控 Amazon Keyspaces
<a name="creating-alarms"></a>

您可以为亚马逊密钥空间创建亚马逊 CloudWatch 警报，当警报状态发生变化时，该警报会发送亚马逊简单通知服务 (Amazon SNS) Simple Notification Service 消息。告警会监控您指定的时间段内的某个指标。它在多个时间段内根据相对于给定阈值的指标值，执行一项或多项操作。操作是一个发送到 Amazon SNS 主题或 Application Auto Scaling 策略的通知。

当您在预配置模式下使用 Amazon Keyspaces 和 Application Auto Scaling 时，该服务会代表您创建两对 CloudWatch 警报。每对警报均表示预置和使用的吞吐量设置的上限和下限。当表的实际利用率在持续一段时间内偏离目标利用率时，就会触发这些 CloudWatch 警报。要了解有关 Application Auto Scaling 创建的 CloudWatch 警报的更多信息，请参阅[Amazon Keyspaces 自动扩缩的工作原理](autoscaling.md#autoscaling.HowItWorks)。

警报仅针对持续的状态变化调用操作。 CloudWatch 警报不会仅仅因为它们处于特定状态就调用操作。该状态必须已改变并在指定的若干个时间段内保持不变。

有关创建 CloudWatch 警报的更多信息，请参阅[亚马逊* CloudWatch 用户指南中的使用亚马逊 CloudWatch *警报](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)。