Amazon DynamoDB monitoring integration

Important

Enable the AWS CloudWatch Metric Streams integration to monitor all CloudWatch metrics from your AWS services, including custom namespaces. Individual integrations are no longer our recommended option.

New Relic infrastructure integrations include an integration for reporting Amazon DynamoDB data to New Relic. This document explains how to activate this integration and describes the data that can be reported.

Features

Amazon DynamoDB is a fully managed NoSQL cloud database that supports both document and key-value store models. With the New Relic DynamoDB Integration, you can quickly understand how request latency or errors are affecting your environment. You'll receive metrics about how the database is performing, service status, and host metadata.

Activate integration

To enable this integration follow standard procedures to Connect AWS services to New Relic.

Configuration and polling

You can change the polling frequency and filter data using configuration options.

Default polling information for the Amazon DynamoDB integration:

New Relic polling interval: 5 minutes
Amazon CloudWatch data interval: 1 minute or 5 minutes, depending on statistic

View and use data

To view and use your integration data, go to one.newrelic.com > All capabilities > Infrastructure > AWS and select one of the Amazon DynamodDB integration links.

You can query and explore your data using the DatastoreSample event type, with a provider value of DynamoDbTable for DynamoDB tables, DynamoDbRegion for regions, or DynamoDbGlobalSecondaryIndex for DynamoDB global secondary indexes.

Metric data

The New Relic Amazon DynamoDB integration collects the following metric data:

Tip

Data indicated with an asterisk * is only fetched if extended inventory collection is on.

DynamoDbTable

Metric	Description
`batchGetSuccessfulRequestLatency`	Elapsed time for successful BatchGetItem operation requests, in milliseconds.
`batchGetThrottledRequests`	BatchGetItem operation requests that exceed the provisioned throughput limits on a table.
`batchWriteSuccessfulRequestLatency`	Elapsed time for successful BatchWriteItem operation requests, in milliseconds.
`batchWriteThrottledRequests`	BatchWriteItem operation requests that exceed the provisioned throughput limits on a table.
`conditionalCheckFailedRequests`	The number of failed attempts to perform conditional writes.
`consumedReadCapacityUnits`	The number of read capacity units consumed over the specified time period, to track how much of provisioned throughput is used.
`consumedWriteCapacityUnits`	The number of write capacity units consumed over the specified time period, to track how much of provisioned throughput is used.
`deleteSuccessfulRequestLatency`	Elapsed time for successful Delete operation requests, in milliseconds.
`deleteThrottledRequests`	Delete operation requests that exceed the provisioned throughput limits on a table.
`getSuccessfulRequestLatency`	Elapsed time for successful Get operation requests, in milliseconds.
`getThrottledRequests`	Get operation requests that exceed the provisioned throughput limits on a table.
`pendingReplicationCount*`	The number of item updates that are written to one replica table, but that have not yet been written to another replica in the global table.
`provisionedReadCapacityUnits`	The number of provisioned read capacity units for a table.
`provisionedWriteCapacityUnits`	The number of provisioned write capacity units for a table.
`putSuccessfulRequestLatency`	Elapsed time for successful Put operation requests, in milliseconds.
`putThrottledRequests`	Put operation requests that exceed the provisioned throughput limits on a table.
`queryReturnedItemCount`	The number of items returned by Query operations.
`querySuccessfulRequestLatency`	Elapsed time for successful Query operation requests, in milliseconds.
`queryThrottledRequests`	Query operation requests that exceed the provisioned throughput limits on a table.
`readThrottleEvents`	Requests to DynamoDB that exceed the provisioned read capacity units for a table.
`replicationLatency`*	The elapsed time between an updated item appearing in the DynamoDB stream for one replica table, and that item appearing in another replica in the global table, in milliseconds.
`scanReturnedItemCount`	The number of items returned by Scan operations.
`scanSuccessfulRequestLatency`	Elapsed time for successful Scan operation requests, in milliseconds.
`scanThrottledRequests`	Scan operation requests that exceed the provisioned throughput limits on a table.
`batchGetSystemErrors`	`BatchGetItem` operation requests that generate an HTTP 500 status code.
`batchWriteSystemErrors`	`BatchWriteItem` operation requests that generate an HTTP 500 status code.
`deleteSystemErrors`	`DeleteItem` operation requests that generate an HTTP 500 status code.
`getSystemErrors`	`GetItem` operation requests that generate an HTTP 500 status code.
`putSystemErrors`	`PutItem` operation requests that generate an HTTP 500 status code.
`querySystemErrors`	`Query` operation requests that generate an HTTP 500 status code.
`scanSystemErrors`	`Scan` operation requests that generate an HTTP 500 status code.
`updateSystemErrors`	`UpdateItem` operation requests that generate an HTTP 500 status code.
`updateSuccessfulRequestLatency`	Elapsed time for successful Update operation requests, in milliseconds.
`updateThrottledRequests`	Update operation requests that exceed the provisioned throughput limits on a table.
`writeThrottleEvents`	Requests to DynamoDB that exceed the provisioned write capacity units for a table.

DynamoDbRegion

This sample limits the data to a particular AWS region. It is used with metrics originating from replica tables within a DynamoDB global table.

Metric	Description
`systemErrors`	Requests that generate an HTTP 500 status code.
`userErrors`	Requests that generate an HTTP 400 status code

DynamoDbGlobalSecondaryIndex

Metric	Description
`consumedReadCapacityUnits`	The number of read capacity units consumed over the specified time period, to track how much of provisioned throughput is used.
`consumedWriteCapacityUnits`	The number of write capacity units consumed over the specified time period, to track how much of provisioned throughput is used.
`onlineIndexConsumedWriteCapacity`	The number of write capacity units consumed when adding a new global secondary index to a table.
`onlineIndexPercentageProgress`	The percentage of completion when a new global secondary index is being added to a table.
`onlineIndexThrottleEvents`	The number of write throttle events that occur when adding a new global secondary index to a table.
`provisionedReadCapacityUnits`	The number of provisioned read capacity units for a global secondary index.
`provisionedWriteCapacityUnits`	The number of provisioned write capacity units for a table.
`readThrottleEvents`	Requests to DynamoDB that exceed the provisioned read capacity units for a table.
`writeThrottleEvents`	Requests to DynamoDB that exceed the provisioned write capacity units for a table.