---
title: AWS DMS
description: >-
  Simplifies migrating various data stores like relational databases, data
  warehouses, and NoSQL databases.
breadcrumbs: Docs > Integrations > AWS DMS
---

# AWS DMS
Integration version1.0.0
## Overview{% #overview %}

AWS Database Migration Service (DMS) is a cloud service that makes it easy to migrate relational databases, data warehouses, NoSQL databases, and other types of data stores.

Enable this integration to see all your DMS metrics in Datadog.

## Setup{% #setup %}

### Installation{% #installation %}

If you haven't already, set up the [Amazon Web Services integration](https://docs.datadoghq.com/integrations/amazon_web_services.md) first.

### Metric collection{% #metric-collection %}

1. In the [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services), ensure that `Database Migration Service` is enabled under the `Metric Collection` tab.
1. Install the [Datadog - AWS Database Migration Service (DMS) integration](https://app.datadoghq.com/integrations/amazon-dms).

### Log collection{% #log-collection %}

#### Enable logging{% #enable-logging %}

Configure AWS Database Migration Service to send logs either to a S3 bucket or to CloudWatch.

**Note**: If you log to a S3 bucket, make sure that `amazon_dms` is set as *Target prefix*.

#### Send logs to Datadog{% #send-logs-to-datadog %}

**Note**: Datadog's [automatic trigger setup](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function.md?tab=awsconsole#automatically-set-up-triggers) is available for CloudWatch log groups only. For S3 buckets, use the [manual trigger setup](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function.md#collecting-logs-from-s3-buckets).

1. If you haven't already, set up the [Datadog Forwarder Lambda function](https://docs.datadoghq.com/logs/guide/forwarder.md).

1. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your AWS DMS logs in the AWS console:

   - [Add a manual trigger on the S3 bucket](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function.md#collecting-logs-from-s3-buckets)
   - [Add a manual trigger on the CloudWatch Log Group](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function.md#collecting-logs-from-cloudwatch-log-group)

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **aws.dms.cdcchanges\_disk\_source**(gauge)                  | Amount of rows accumulating on disk and waiting to be committed from the source*Shown as row*                                                                                 |
| **aws.dms.cdcchanges\_disk\_target**(gauge)                  | Amount of rows accumulating on disk and waiting to be committed to the target*Shown as row*                                                                                   |
| **aws.dms.cdcchanges\_memory\_source**(gauge)                | Amount of rows accumulating in a memory and waiting to be committed from the source*Shown as row*                                                                             |
| **aws.dms.cdcchanges\_memory\_target**(gauge)                | Amount of rows accumulating in a memory and waiting to be committed to the target*Shown as row*                                                                               |
| **aws.dms.cdcincoming\_changes**(gauge)                      | Total row count of changes for the task*Shown as row*                                                                                                                         |
| **aws.dms.cdclatency\_source**(gauge)                        | Latency reading from source*Shown as second*                                                                                                                                  |
| **aws.dms.cdclatency\_target**(gauge)                        | Latency writing to the target*Shown as second*                                                                                                                                |
| **aws.dms.cdcthroughput\_bandwidth\_source**(gauge)          | Incoming task network bandwidth from the source*Shown as kibibyte*                                                                                                            |
| **aws.dms.cdcthroughput\_bandwidth\_target**(gauge)          | Outgoing task network bandwidth for the target*Shown as kibibyte*                                                                                                             |
| **aws.dms.cdcthroughput\_rows\_source**(gauge)               | Incoming task changes from the source*Shown as row*                                                                                                                           |
| **aws.dms.cdcthroughput\_rows\_target**(gauge)               | Outgoing task changes for the target*Shown as row*                                                                                                                            |
| **aws.dms.cpuutilization**(gauge)                            | The amount of CPU used.*Shown as percent*                                                                                                                                     |
| **aws.dms.freeable\_memory**(gauge)                          | The amount of available random access memory.*Shown as byte*                                                                                                                  |
| **aws.dms.full\_load\_throughput\_bandwidth\_source**(gauge) | Incoming network bandwidth from a full load from the source*Shown as kibibyte*                                                                                                |
| **aws.dms.full\_load\_throughput\_bandwidth\_target**(gauge) | Outgoing network bandwidth from a full load for the target*Shown as kibibyte*                                                                                                 |
| **aws.dms.full\_load\_throughput\_rows\_source**(gauge)      | Incoming changes from a full load from the source in rows per second*Shown as row*                                                                                            |
| **aws.dms.full\_load\_throughput\_rows\_target**(gauge)      | Outgoing changes from a full load for the target*Shown as row*                                                                                                                |
| **aws.dms.network\_receive\_throughput**(gauge)              | The incoming (Receive) network traffic on the DB instance including both customer database traffic and Amazon RDS traffic used for monitoring and replication.*Shown as byte* |
| **aws.dms.network\_transmit\_throughput**(gauge)             | The outgoing (Transmit) network traffic on the DB instance including both customer database traffic and Amazon RDS traffic used for monitoring and replication*Shown as byte* |
| **aws.dms.read\_iops**(gauge)                                | The average number of disk I/O operations per second.*Shown as operation*                                                                                                     |
| **aws.dms.read\_latency**(gauge)                             | The average amount of time taken per read disk I/O operation*Shown as second*                                                                                                 |
| **aws.dms.read\_throughput**(gauge)                          | The average number of bytes read from disk per second.*Shown as byte*                                                                                                         |
| **aws.dms.swap\_usage**(gauge)                               | The amount of swap space used on the DB Instance*Shown as byte*                                                                                                               |
| **aws.dms.write\_iops**(gauge)                               | The average number of disk I/O operations per second*Shown as operation*                                                                                                      |
| **aws.dms.write\_latency**(gauge)                            | The average amount of time taken per write disk I/O operation*Shown as second*                                                                                                |
| **aws.dms.write\_throughput**(gauge)                         | The average number of bytes written to disk per second.*Shown as byte*                                                                                                        |
| **aws.dms.free\_storage\_space**(gauge)                      | The amount of available storage space*Shown as byte*                                                                                                                          |

### Events{% #events %}

The AWS Database Migration Service (DMS) integration does not include any events.

### Service Checks{% #service-checks %}

The AWS Database Migration Service (DMS) integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).
