Amazon DynamoDB

<div class="condensed-table">
| | |
| --- | --- |
| Version | 2.38.2 (View all) |
| Compatible Kibana version(s) | 8.16.2 or higher |
| Supported Serverless project types
What’s this? | Security
Observability |
| Subscription level
What’s this? | Basic |

</div>
The Amazon DynamoDB integration allows you to monitor Amazon DynamoDB—a key-value NoSQL database.

Use the Amazon DynamoDB integration to collect metrics related to your Amazon DynamoDB databases. Then visualize that data in Kibana, create alerts to notify you if something goes wrong, and reference metrics when troubleshooting an issue.

For example, you could use this data to visualize consumed read and write capacity units. You can then create alerts based on used or unused capacity, so that the relevant users can better scale their provisioned throughput capacity. This might mean they increase the capacity to provide more resources, or reduce capacity to save on costs.

The Amazon DynamoDB integration collects one type of data: metrics.

Metrics give you insight into the state of Amazon DynamoDB. Metrics collected by the Amazon DynamoDB integration include the maximum number of read and write capacity units that can be used by an account, consume capacity units, throttle events, and more. See more details in the Metrics reference.

You need Elasticsearch for storing and searching your data and Kibana for visualizing and managing it. You can use our hosted Elasticsearch Service on Elastic Cloud, which is recommended, or self-manage the Elastic Stack on your own hardware.

Before using any AWS integration you will need:

• AWS Credentials to connect with your AWS account.
• AWS Permissions to make sure the user you’re using to connect has permission to share the relevant data.

For more details about these requirements, please take a look at the AWS integration documentation.

Use this integration if you only need to collect data from AWS DynamoDB.

If you want to collect data from two or more AWS services, consider using the AWS integration. When you configure the AWS integration, you can collect data from as many AWS services as you’d like.

For step-by-step instructions on how to set up an integration, see the Getting started guide.

The dynamodb data stream collects DynamoDB metrics from AWS. An example event for dynamodb looks like this:

{
    "@timestamp": "2022-07-25T21:53:00.000Z",
    "agent": {
        "ephemeral_id": "64a12b83-a4f1-487c-8d2c-9581fda6ca2a",
        "id": "2d4b09d0-cdb6-445e-ac3f-6415f87b9864",
        "name": "docker-fleet-agent",
        "type": "metricbeat",
        "version": "8.3.2"
    },
    "aws": {
        "cloudwatch": {
            "namespace": "AWS/DynamoDB"
        },
        "dynamodb": {
            "metrics": {
                "AccountMaxReads": {
                    "max": 80000
                },
                "AccountMaxTableLevelReads": {
                    "max": 40000
                },
                "AccountMaxTableLevelWrites": {
                    "max": 40000
                },
                "AccountMaxWrites": {
                    "max": 80000
                },
                "AccountProvisionedReadCapacityUtilization": {
                    "avg": 0.01
                },
                "AccountProvisionedWriteCapacityUtilization": {
                    "avg": 0.01
                },
                "MaxProvisionedTableReadCapacityUtilization": {
                    "max": 0.01
                },
                "MaxProvisionedTableWriteCapacityUtilization": {
                    "max": 0.01
                }
            }
        }
    },
    "cloud": {
        "account": {
            "id": "428152502467",
            "name": "elastic-beats"
        },
        "provider": "aws",
        "region": "eu-central-1"
    },
    "data_stream": {
        "dataset": "aws.dynamodb",
        "namespace": "default",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "2d4b09d0-cdb6-445e-ac3f-6415f87b9864",
        "snapshot": false,
        "version": "8.3.2"
    },
    "event": {
        "agent_id_status": "verified",
        "dataset": "aws.dynamodb",
        "duration": 10586366300,
        "ingested": "2022-07-25T21:57:51Z",
        "module": "aws"
    },
    "metricset": {
        "name": "cloudwatch",
        "period": 300000
    },
    "service": {
        "type": "aws"
    }
}

ECS Field Reference

Please refer to the following document for detailed information on ECS fields.