• /
  • ログイン

Amazon DynamoDB monitoring integration

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:

ヒント

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

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.

/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

ヒント

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.

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:

問題を作成するこのページを編集する
Copyright © 2020 New Relic Inc.