Documentation forAppOptics

DynamoDB

Overview

Amazon DynamoDB is a fast and flexible NoSQL database service for all applications that need consistent, single-digit millisecond latency at any scale.

Setup

Installation

If you haven't already, first set up the AWS CloudWatch integration. No additional steps are needed for installation.

Configuration

On the AWS CloudWatch integration page, ensure that the DynamoDB service is selected for metric collection.

Metrics

Name Description

ConditionalCheckFailedRequests

(count)

The number of failed attempts to perform conditional writes.

The PutItem, UpdateItem, and DeleteItem 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.

ConsumedReadCapacityUnits

(count)

The number of read capacity units consumed over the specified time period, so you can track how much of your provisioned throughput is used. You can retrieve the total consumed read capacity for a table and all of its global secondary indexes, or for a particular global secondary index.

ConsumedWriteCapacityUnits

(count)

The number of write capacity units consumed over the specified time period, so you can track how much of your provisioned throughput is used. You can retrieve the total consumed write capacity for a table and all of its global secondary indexes, or for a particular global secondary index.

OnlineIndexConsumedWriteCapacity

(count)

The number of write capacity units consumed when adding a new global secondary index to a table. If the write capacity of the index is too low, incoming write activity during the backfill phase might be throttled; this can increase the time it takes to create the index.

You should monitor this statistic while the index is being built to determine whether the write capacity of the index is underprovisioned.

OnlineIndexPercentageProgress

(count)

The percentage of completion when a new global secondary index is being added to a table. DynamoDB must first allocate resources for the new index, and then backfill attributes from the table into the index. For large tables, this process might take a long time.

You should monitor this statistic to view the relative progress as DynamoDB builds the index.

OnlineIndexThrottleEvents

(count)

The number of write throttle events that occur when adding a new global secondary index to a table. These events indicate that the index creation will take longer to complete, because incoming write activity is exceeding the provisioned write throughput of the index.

ProvisionedReadCapacityUnits

(count)

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

ProvisionedWriteCapacityUnits

(count)

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

ReadThrottleEvents

(count)

Requests to DynamoDB that exceed the provisioned read capacity units for a table or a global secondary index.

ReturnedBytes

(bytes)

The number of bytes returned by GetRecords operations (Amazon DynamoDB Streams) during the specified time period.

ReturnedItemCount

(count)

The number of items returned by Query or Scan operations during the specified time period.

ReturnedRecordsCount

(count)

The number of stream records returned by GetRecords operations (Amazon DynamoDB Streams) during the specified time period.

SuccessfulRequestLatency

(milliseconds)

Successful requests to DynamoDB or Amazon DynamoDB Streams during the specified time period.

SystemErrors

(count)

Requests to DynamoDB or Amazon DynamoDB Streams that generate an HTTP 500 status code during the specified time period.

TimeToLiveDeletedItemCount

(count)

The number of items deleted by Time To Live (TTL) during the specified time period. This metric helps you monitor the rate of TTL deletions on your table.

ThrottledRequests

(count)

Requests to DynamoDB that exceed the provisioned throughput limits on a resource (such as a table or an index).

UserErrors

(count)

Requests to DynamoDB or Amazon DynamoDB Streams that generate an HTTP 400 status code during the specified time period.

WriteThrottleEvents

(count)

Requests to DynamoDB that exceed the provisioned write capacity units for a table or a global secondary index.

Available Tags

Name Description
awsaccount AWS account associated with the metrics
globalsecondaryindexname The global secondary index of the table
operation Name of the DynamoDB operation
region Name of the region
tablename Name of the table

When the APM Integrated Experience is enabled, AppOptics shares a common navigation and settings with the other integrated experiences' products. How you navigate AppOptics and access its features may vary from these instructions. For more information, go to the APM Integrated Experience documentation.