---
title: AWS RDS Proxy
description: >-
  A DB proxy for RDS that makes applications more scalable, more resilient to
  database failures, and more secure.
breadcrumbs: Docs > Integrations > AWS RDS Proxy
---

# AWS RDS Proxy

## Overview{% #overview %}

Amazon RDS Proxy is a fully managed, highly available database proxy for Amazon Relational Database Service (RDS) that makes applications more scalable, more resilient to database failures, and more secure.

Enable this integration to see all your RDS Proxy metrics in Datadog.

## Setup{% #setup %}

### Installation{% #installation %}

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

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

1. In the [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services), ensure that `RDS Proxy` is enabled under the `Metric Collection` tab.
1. Install the [Datadog - Amazon RDS Proxy integration](https://app.datadoghq.com/integrations/amazon-rds-proxy).

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

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

When creating an RDS Proxy, logging can be enabled in the advanced configuration. Follow instructions in [Getting started with RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-creating) to start sending your RDS Proxy logs to Cloudwatch.

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

1. If you haven't already, set up the [Datadog log collection AWS Lambda function](https://docs.datadoghq.com/integrations/amazon_web_services.md?tab=roledelegation#log-collection).
1. Once the Lambda function is installed, manually add a trigger on the CloudWatch log group that contains your RDS Proxy logs. Select the corresponding CloudWatch log group, add a filter name (optional), and add the trigger.

Once done, go to the [Datadog Log Explorer](https://app.datadoghq.com/logs) to analyze your logs.

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

### Metrics{% #metrics %}

|  |
|  |
| **aws.rds.proxy.availability\_percentage**(gauge)                          | The percentage of time for which the target group was available in its role.*Shown as percent*                    |
| **aws.rds.proxy.client\_connections**(gauge)                               | The current number of client connections.*Shown as connection*                                                    |
| **aws.rds.proxy.client\_connections\_closed**(gauge)                       | The number of client connections closed.*Shown as connection*                                                     |
| **aws.rds.proxy.client\_connections\_no\_tls**(gauge)                      | The current number of client connections without Transport Layer Security (TLS).*Shown as connection*             |
| **aws.rds.proxy.client\_connections\_received**(gauge)                     | The number of client connection requests received.*Shown as connection*                                           |
| **aws.rds.proxy.client\_connections\_setup\_failed\_auth**(gauge)          | The number of client connection attempts that failed.*Shown as connection*                                        |
| **aws.rds.proxy.client\_connections\_setup\_succeeded**(gauge)             | The number of client connections successfully established.*Shown as connection*                                   |
| **aws.rds.proxy.client\_connections\_tls**(gauge)                          | The current cumber of client connections with TLS.*Shown as connection*                                           |
| **aws.rds.proxy.database\_connection\_requests**(gauge)                    | The number of requests to create a DB connection.*Shown as request*                                               |
| **aws.rds.proxy.database\_connection\_requests\_with\_tls**(gauge)         | The number of requests to create a DB connection with TLS.*Shown as request*                                      |
| **aws.rds.proxy.database\_connections**(gauge)                             | The current number of database connections.*Shown as connection*                                                  |
| **aws.rds.proxy.database\_connections\_borrow\_latency**(gauge)            | The time in microseconds that it takes for the proxy to get a DB connection.*Shown as microsecond*                |
| **aws.rds.proxy.database\_connections\_currently\_borrowed**(gauge)        | The current number of database connections in the borrow state.*Shown as connection*                              |
| **aws.rds.proxy.database\_connections\_currently\_in\_transaction**(gauge) | The current number of database connections in a transaction.*Shown as connection*                                 |
| **aws.rds.proxy.database\_connections\_currently\_session\_pinned**(gauge) | The current number of database connections currently pinned.*Shown as connection*                                 |
| **aws.rds.proxy.database\_connections\_setup\_failed**(gauge)              | The number of database connection requests that failed.*Shown as connection*                                      |
| **aws.rds.proxy.database\_connections\_setup\_succeeded**(gauge)           | The number of database connections successfully established.*Shown as connection*                                 |
| **aws.rds.proxy.database\_connections\_with\_tls**(gauge)                  | The current number of database connections with TLS.*Shown as connection*                                         |
| **aws.rds.proxy.max\_database\_connections\_allowed**(gauge)               | The maximum number of database connections allowed.*Shown as connection*                                          |
| **aws.rds.proxy.query\_database\_response\_latency**(gauge)                | The time in microseconds that the database took to respond to the query.*Shown as microsecond*                    |
| **aws.rds.proxy.query\_requests**(gauge)                                   | The number of queries received (a query including multiple statements is counted as one query).*Shown as request* |
| **aws.rds.proxy.query\_requests\_no\_tls**(gauge)                          | The number of queries received from non-TLS connections.*Shown as request*                                        |
| **aws.rds.proxy.query\_requests\_tls**(gauge)                              | The number of queries received from TLS connections.*Shown as request*                                            |
| **aws.rds.proxy.query\_response\_latency**(gauge)                          | The time in microseconds between getting a query request and the proxy responding to it.*Shown as microsecond*    |

### Events{% #events %}

The Amazon RDS Proxy integration does not include any events.

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

The Amazon RDS Proxy integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

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