# DynamoDB

DynamoDB is a fully managed proprietary NoSQL database service that supports key-value and document data structures and is offered by Amazon as part of the Amazon Web Services portfolio. Amazon CloudWatch aggregates the DynamoDB metrics at one-minute intervals.

In DynamoDB, provisioned throughput requirements are specified in terms of capacity units: Read Capacity unit and Write Capacity unit. A unit of read capacity represents one strongly consistent read per second for items up to 4 KB in size. One write capacity unit represents one write per second for items up to 1 KB in size. Larger items will require more capacity. You can calculate the number of units of read and write capacity by estimating the number of reads or writes required per second and multiplying by the size of the items rounded up to the nearest KB.

For more information, see the Amazon DynamoDB documentation.

## aws.dynamodb.ConditionalCheckFailedRequests

The number of failed attempts to perform conditional writes.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.ConsumedReadCapacityUnits

The amount of read capacity units consumed over the defined time period.
Amazon CloudWatch aggregates the metrics at one-minute intervals. Use
the Sum aggregation to calculate the consumed throughput. For example,
get the Sum value over a span of one minute, and divide it by the number
of seconds in a minute (60) to calculate the
average `ConsumedReadCapacityUnits`

per second.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.ConsumedWriteCapacityUnits

The amount of write capacity units consumed over the specified time
interval. Amazon CloudWatch aggregates the metrics at one-minute
intervals. Use the Sum aggregation to calculate the consumed throughput.
For example, get the Sum value over a span of one minute, and divide it
by the number of seconds in a minute (60) to calculate the
average `ConsumedWriteCapacityUnits`

per second.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.ProvisionedReadCapacityUnits

The number of read capacity units provisioned for a table or a global secondary index.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.ProvisionedWriteCapacityUnits

The number of write capacity units provisioned for a table or global secondary table.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.ReadThrottleEvents

The number of DynamoDB requests that exceed the amount of read capacity units provisioned.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.ReturnedBytes.GetRecords

The number of bytes returned by `GetRecords`

operation during the
specified time period.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Byte |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.ReturnedItemCount

The number of items returned by query or scan operations during the specified time period.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.ReturnedRecordsCount.GetRecords

The number of stream records returned by the GetRecords operations during the specific period.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.SuccessfulRequestLatency

The number of successful requests to DynamoDB or Amazon DynamoDB Streams during the specified time period. The time period is in milliseconds.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.SystemErrors

The number of requests made to DynamoDB or Amazon DynamoDB Streams that resulted in an HTTP 500 status code during the specified time period. HTTP 500 usually indicates an internal service error.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.ThrottledRequests

The number of requests to DynamoDB that exceed the provisioned throughput limits on a resource, such as a table or an index. ThrottledRequests is incremented by one if any event within a request exceeds a provisioned throughput limit.

If any individual request for read or write events within the batch is
throttled, `ReadThrottleEvents`

metrics or `WriteThrottleEvents`

metrics
is incremented respectively.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.UserErrors

The number of requests to DynamoDB or Amazon DynamoDB Streams that returned an HTTP 400 status code during the specified time period. HTTP 400 usually indicates a client-side error.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## aws.dynamodb.WriteThrottleEvents

The number of requests to DynamoDB that exceed the provisioned write capacity units for a table or a global secondary index.

Metadata | Description |
---|---|

Metric Type | Counter |

Value Type | Integer |

Segment By | CloudProvider |

Default Time Aggregation | Rate |

Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |

Default Group Aggregation | Sum |

Available Group Aggregation Formats | Avg, Sum, Min, Max |

## Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.