• Log inStart now

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 > 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.

userErrors

Requests that generate an HTTP 400 status code.

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.

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.