Amazon DynamoDB monitoring integration | New Relic Documentation

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, as well as inventory data like configuration settings, 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.

Inventory data

EOL NOTICE

After March 2022, we're discontinuing support for several capabilities, including inventory data for cloud integrations. For more details, including how you can easily prepare for this transition, see our Explorers Hub post.

Inventory data provides information about a service's state and configuration, and available host information.

/limits

Name	Description
`accountMaxReadCapacity`	The maximum total read capacity units that your account allows you to provision across all of your tables in this region.
`accountMaxWriteCapacity`	The maximum total write capacity units that your account allows you to provision across all of your tables in this region.
`awsRegion`	The AWS region that the table was provisioned in.
`tableMaxReadCapacity`	The maximum read capacity units allowed by your account to provision a new table created in this region, including the read capacity units provisioned for its Global Secondary Indexes (GSIs).
`tableMaxWriteCapacity`	The maximum write capacity units allowed by your account to provision a new table created in this region, including the write capacity units provisioned for its Global Secondary Indexes (GSIs).

/table

Name	Description
`awsRegion`	The AWS region that the table was provisioned in.
`tableStatus`	The state of the table: `creating`: The table is being created. `updating`: The table is being updated. `deleting`: The table is being deleted. `active`: The table is ready for use.

Name

Description

awsRegion

The AWS region that the table was provisioned in.

tableStatus

The state of the table:

creating: The table is being created.
updating: The table is being updated.
deleting: The table is being deleted.
active: The table is ready for use.

/table/provisionedThroughput

Name	Description
`numberOfDecreasesToday`	The number of provisioned throughput decreases for this table during this UTC calendar day. For current maximums on provisioned throughput decreases, see Limits in DynamoDB.
`readCapacityUnits`	The maximum number of strongly consistent reads consumed per second before DynamoDB returns a `ThrottlingException`. Eventually, consistent reads require less effort than strongly consistent reads, so a setting of 50 `ReadCapacityUnits` per second provides 100 eventually consistent `ReadCapacityUnits` per second.
`writeCapacityUnits`	The maximum number of writes consumed per second before DynamoDB returns a `ThrottlingException`.

/table/dynamodb/table

Tip

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

Name	Description
`tableName`	The name of the table.
`creationDate`	The date and time when the table was created in UNIX epoch time.
`tableStatus`	The current state of the table: `CREATING` - The table is being created. `UPDATING` - The table is being updated. `DELETING` - The table is being deleted. `ACTIVE` - The table is ready for use.
`keySchema`	The complete index key schema.
`attributeDefinition`	The list of `AttributeDefinition` objects. Each of these objects describes one attribute in the table and index key schema. Each `AttributeDefinition` object in this list is composed of: `AttributeName` - The name of the attribute. `AttributeType` - The data type for the attribute.
`provisionedThroughput`	The provisioned throughput settings for the table, consisting of read and write capacity units, along with data about increases and decreases.
`streamSpecification`	The current DynamoDB Streams configuration for the table.
`globalSecondaryIndexes`	The global secondary indexes, if any, on the table.
`creationDateTime`*	The date and time when the global table was created. in UNIX epoch time.
`globalTableName`*	The global table name.
`globalTableStatus`*	The current state of the global table: `CREATING` - The global table is being created. `UPDATING` - The global table is being updated. `DELETING` - The global table is being deleted. `ACTIVE` - The global table is ready for use.
`replicationGroup`*	The regions where the global table has replicas.