Amazon Keyspaces Metrics and Dimensions - Amazon Keyspaces (for Apache Cassandra)

Amazon Keyspaces Metrics and Dimensions

When you interact with Amazon Keyspaces, it sends the following metrics and dimensions to Amazon CloudWatch. All metrics are aggregated and reported every minute. You can use the following procedures to view the metrics for Amazon Keyspaces.

To view metrics using the CloudWatch console

Metrics are grouped first by the service namespace, and then by the various dimension combinations within each namespace.

  1. Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. If necessary, change the Region. On the navigation bar, choose the Region where your AWS resources reside. For more information, see AWS Service Endpoints.

  3. In the navigation pane, choose Metrics.

  4. Under the All metrics tab, choose AWS/Cassandra.

To view metrics using the AWS CLI

  • At a command prompt, use the following command.

    aws cloudwatch list-metrics --namespace "AWS/Cassandra"

Amazon Keyspaces Metrics and Dimensions

The metrics and dimensions that Amazon Keyspaces sends to Amazon CloudWatch are listed here.

Amazon Keyspaces Metrics

Amazon CloudWatch aggregates Amazon Keyspaces metrics at one-minute intervals.

Not all statistics, such as Average or Sum, are applicable for every metric. However, all of these values are available through the Amazon Keyspaces console, or by using the CloudWatch console, AWS CLI, or AWS SDKs for all metrics. In the following table, each metric has a list of valid statistics that are applicable to that metric.

Metric Description
AccountMaxTableLevelReads

The maximum number of read capacity units that can be used by a table of an account. For on-demand tables this limit caps the maximum read request units a table can use.

Units: Count

Valid Statistics:

  • Maximum – The maximum number of read capacity units that can be used by a table of the account.

AccountMaxTableLevelWrites

The maximum number of write capacity units that can be used by a table of an account. For on-demand tables this limit caps the maximum write request units a table can use.

Units: Count

Valid Statistics:

  • Maximum – The maximum number of write capacity units that can be used by a table of the account.

AccountProvisionedReadCapacityUtilization

The percentage of provisioned read capacity units utilized by an account.

Units: Percent

Valid Statistics:

  • Maximum – The maximum percentage of provisioned read capacity units utilized by the account.

  • Minimum – The minimum percentage of provisioned read capacity units utilized by the account.

  • Average – The average percentage of provisioned read capacity units utilized by the account. The metric is published for five-minute intervals. Therefore, if you rapidly adjust the provisioned read capacity units, this statistic might not reflect the true average.

AccountProvisionedWriteCapacityUtilization

The percentage of provisioned write capacity units utilized by an account.

Units: Percent

Valid Statistics:

  • Maximum – The maximum percentage of provisioned write capacity units utilized by the account.

  • Minimum – The minimum percentage of provisioned write capacity units utilized by the account.

  • Average – The average percentage of provisioned write capacity units utilized by the account. The metric is published for five-minute intervals. Therefore, if you rapidly adjust the provisioned write capacity units, this statistic might not reflect the true average.

ConditionalCheckFailedRequests

The number of failed lightweight transaction (LWT) write requests. The INSERT, UPDATE, and DELETE operations let you provide a logical condition that must evaluate to true before the operation can proceed. If this condition evaluates to false, ConditionalCheckFailedRequests is incremented by one.

Units: Count

Dimensions: Keyspace, TableName

Valid Statistics:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

ConsumedReadCapacityUnits

The number of read capacity units consumed over the specified time period. For more information, see Read/Write Capacity Mode.

Note

To understand your average throughput utilization per second, use the Sum statistic to calculate the consumed throughput for the one minute period. Then divide the sum by the number of seconds in a minute (60) to calculate the average ConsumedReadCapacityUnits per second (recognizing that this average does not highlight any large but brief spikes in read activity that occurred during that minute). For more information on comparing average consumed read capacity to provisioned read capacity, see How Do I Use Amazon Keyspaces Metrics?

Units: Count

Dimensions: Keyspace, TableName

Valid Statistics:

  • Minimum – The minimum number of read capacity units consumed by any individual request to the table.

  • Maximum – The maximum number of read capacity units consumed by any individual request to the table.

  • Average – The average per-request read capacity consumed.

    Note

    The Average value is influenced by periods of inactivity where the sample value will be zero.

  • Sum – The total read capacity units consumed. This is the most useful statistic for the ConsumedReadCapacityUnits metric.

  • SampleCount – The number of requests to Amazon Keyspaces, even if no read capacity was consumed.

    Note

    The SampleCount value is influenced by periods of inactivity where the sample value will be zero.

ConsumedWriteCapacityUnits

The number of write capacity units consumed over the specified time period. You can retrieve the total consumed write capacity for a table. For more information, see Read/Write Capacity Mode.

Note

To understand your average throughput utilization per second, use the Sum statistic to calculate the consumed throughput for the one minute period. Then divide the sum by the number of seconds in a minute (60) to calculate the average ConsumedWriteCapacityUnits per second (recognizing that this average does not highlight any large but brief spikes in write activity that occurred during that minute). For more information on comparing average consumed write capacity to provisioned write capacity, see How Do I Use Amazon Keyspaces Metrics?

Units: Count

Dimensions: Keyspace, TableName

Valid Statistics:

  • Minimum – The minimum number of write capacity units consumed by any individual request to the table.

  • Maximum – The maximum number of write capacity units consumed by any individual request to the table.

  • Average – The average per-request write capacity consumed.

    Note

    The Average value is influenced by periods of inactivity where the sample value will be zero.

  • Sum – The total write capacity units consumed. This is the most useful statistic for the ConsumedWriteCapacityUnits metric.

  • SampleCount – The number of requests to Amazon Keyspaces, even if no write capacity was consumed.

    Note

    The SampleCount value is influenced by periods of inactivity where the sample value will be zero.

MaxProvisionedTableReadCapacityUtilization

The percentage of provisioned read capacity units utilized by the highest provisioned read table of an account.

Units: Percent

Valid Statistics:

  • Maximum – : The maximum percentage of provisioned read capacity units utilized by the highest provisioned read table of the account.

  • Minimum – The minimum percentage of provisioned read capacity units utilized by the highest provisioned read table of the account.

  • Average – The average percentage of provisioned read capacity units utilized by the highest provisioned read table of the account. The metric is published for five-minute intervals. Therefore, if you rapidly adjust the provisioned read capacity units, this statistic might not reflect the true average.

MaxProvisionedTableWriteCapacityUtilization

The percentage of provisioned write capacity utilized by the highest provisioned write table of an account.

Units: Percent

Valid Statistics:

  • Maximum – The maximum percentage of provisioned write capacity units utilized by the highest provisioned write table of the account.

  • Minimum – The minimum percentage of provisioned write capacity units utilized by the highest provisioned write table of the account.

  • Average – The average percentage of provisioned write capacity units utilized by the highest provisioned write table of the account. The metric is published for five-minute intervals. Therefore, if you rapidly adjust the provisioned write capacity units, this statistic might not reflect the true average.

ProvisionedReadCapacityUnits

The number of provisioned read capacity units for a table.

The TableName dimension returns the ProvisionedReadCapacityUnits for the table.

Units: Count

Dimensions: Keyspace, TableName

Valid Statistics:

  • Minimum – The lowest setting for provisioned read capacity. If you use ALTER TABLE to increase read capacity, this metric shows the lowest value of provisioned ReadCapacityUnits during this time period.

  • Maximum – The highest setting for provisioned read capacity. If you use ALTER TABLE to decrease read capacity, this metric shows the highest value of provisioned ReadCapacityUnits during this time period.

  • Average – The average provisioned read capacity. The ProvisionedReadCapacityUnits metric is published at five-minute intervals. Therefore, if you rapidly adjust the provisioned read capacity units, this statistic might not reflect the true average.

ProvisionedWriteCapacityUnits

The number of provisioned write capacity units for a table.

The TableName dimension returns the ProvisionedWriteCapacityUnits for the table.

Units: Count

Dimensions: Keyspace, TableName

Valid Statistics:

  • Minimum – The lowest setting for provisioned write capacity. If you use ALTER TABLE to increase write capacity, this metric shows the lowest value of provisioned WriteCapacityUnits during this time period.

  • Maximum – The highest setting for provisioned write capacity. If you use ALTER TABLE to decrease write capacity, this metric shows the highest value of provisioned WriteCapacityUnits during this time period.

  • Average – The average provisioned write capacity. The ProvisionedWriteCapacityUnits metric is published at five-minute intervals. Therefore, if you rapidly adjust the provisioned write capacity units, this statistic might not reflect the true average.

ReadThrottleEvents

Requests to Amazon Keyspaces that exceed the provisioned read capacity for a table.

Units: Count

Dimensions: Keyspace, TableName, Operation

Valid Statistics:

  • SampleCount

  • Sum

ReturnedItemCount

The number of rows returned by multi-row SELECT queries during the specified time period. Multi-row SELECT queries are queries which do not contain the fully qualified primary key, such a full table scans and range queries.

The number of rows returned is not necessarily the same as the number of rows that were evaluated. For example, suppose that you requested a SELECT * with ALLOW FILTERING on a table that had 100 rows, but specified a WHERE clause that narrowed the results so that only 15 rows were returned. In this case, the response from SELECT would contain a ScanCount of 100 and a Count of 15 returned rows.

Units: Count

Dimensions: Keyspace, TableName, Operation

Valid Statistics:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

SuccessfulRequestLatency

The successful requests to Amazon Keyspaces during the specified time period. SuccessfulRequestLatency can provide two different kinds of information:

  • The elapsed time for successful requests (Minimum, Maximum, Sum, or Average).

  • The number of successful requests (SampleCount).

SuccessfulRequestLatency reflects activity only within Amazon Keyspaces and does not take into account network latency or client-side activity.

Units: Milliseconds

Dimensions: Keyspace, TableName, Operation

Valid Statistics:

  • Minimum

  • Maximum

  • Average

  • SampleCount

SystemErrors

The requests to Amazon Keyspaces that generate a ServerError during the specified time period. A ServerError usually indicates an internal service error.

Units: Count

Dimensions: All dimensions

Valid Statistics:

  • Sum

  • SampleCount

UserErrors

Requests to Amazon Keyspaces that generate an InvalidRequest error during the specified time period. An InvalidRequest usually indicates a client-side error, such as an invalid combination of parameters, an attempt to update a nonexistent table, or an incorrect request signature.

UserErrors represents the aggregate of invalid requests for the current AWS Region and the current AWS account.

Units: Count

Valid Statistics:

  • Sum

  • SampleCount

WriteThrottleEvents

Requests to Amazon Keyspaces that exceed the provisioned write capacity for a table.

Units: Count

Dimensions: Keyspace, TableName, Operation

Valid Statistics:

  • SampleCount

  • Sum

Dimensions for Amazon Keyspaces Metrics

The metrics for Amazon Keyspaces are qualified by the values for the account, table name, or operation. You can use the CloudWatch console to retrieve Amazon Keyspaces data along any of the dimensions in the following table.

Dimension Description
Keyspace

This dimension limits the data to a specific keyspace. This value can be any keyspace in the current Region and the current AWS account.

Operation

This dimension limits the data to one of the Amazon Keyspaces CQL operations, such as INSERT or SELECT operations.

TableName

This dimension limits the data to a specific table. This value can be any table name in the current Region and the current AWS account. If the table name is not unique within the account, you must also specify Keyspace.