AWS DynamoDB

Learn about other supported AWS services on our AWS docs.

Sensor (Data Collection)

Tracked Configuration

DynamoDB Table Details

  • Table Arn
  • Table Name
  • Table Status
  • Table Item Count
  • Table Created At
  • Table Size (bytes)
  • Table Stream Arn
  • Table Stream Label
  • Grouping zone (region)

Metrics

  • Consumed read capacity
  • Provisioned read capacity
  • Consumed write capacity
  • Provisioned write capacity
  • Throttled read requests (Get, Scan, Query, Batch Get)
  • Throttled write requests (Put, Update, Delete, Batch Write)
  • TTL Deleted Items
  • Conditional check failed
  • User errors
  • System errors read (Get, Scan, Query,Batch get)
  • System errors write (Put, Update, Delete, Batch write)
  • Returned query item count (Minimum, Maximum, Average, Sum)
  • Returned scan item count (Minimum, Maximum, Average, Sum)
  • Batch get latency (Minimum, Maximum, Average, Sum, Request count)
  • Batch write latency (Minimum, Maximum, Average, Sum, Request count)
  • Delete latency (Minimum, Maximum, Average, Sum, Request count)
  • Get latency (Minimum, Maximum, Average, Sum, Request count)
  • Put latency (Minimum, Maximum, Average, Sum, Request count)
  • Query latency (Minimum, Maximum, Average, Sum, Request count)
  • Scan latency (Minimum, Maximum, Average, Sum, Request count)
  • Update latency (Minimum, Maximum, Average, Sum, Request count)

For more information refer to Amazon DynamoDB Metrics and Dimensions.

Health Signatures

  • Ratio of consumed and provisioned reads is critical
  • Ratio of consumed and provisioned writes is critical

Required Permissions

  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • dynamodb:ListTables
  • dynamodb:DescribeTable
  • dynamodb:ListTagsOfResource

Configuration

Metrics for DynamoDB are pulled every 5 minutes, this can be changed via agent configuration in <agent_install_dir>/etc/instana/configuration.yml:

com.instana.plugin.aws.dynamodb:
  cloudwatch_period: 300

To disable monitoring of DynamoDB instances use the following configuration:

com.instana.plugin.aws.dynamodb:
  enabled: false

Multiple tags can be defined, separated by a comma. Tags should be provided as a key-value pair separated by :. In order to make configuration easier, it is possible to define which tags you want to include in discovery or exclude from discovery. In case of defining tag in both lists (include and exclude), exclude list has higher priority. If there is no need for services filtering, the configuration should not be defined. It’s not mandatory to define all values in order to enable filtering.

Users are able to specify how often sensors will poll the AWS tagged resources using the tagged-servies-poll-rate configuration property (default 300 seconds).

To define how often sensors will poll the tagged resources use following configuration:

com.instana.plugin.aws:
  tagged-servies-poll-rate: 60 #default 300

To include services by tags into discovery use following configuration:

com.instana.plugin.aws.dynamodb:
    include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

To exclude services by tags from discovery use following configuration:

com.instana.plugin.aws.dynamodb:
    exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Instana Agent Tags

Please note that tags are currently only available in conjunction with the dedicated AWS Instana agent, described here AWS Agent Installation docs. More details on using tags are described here.