Amazon RDS Proxy

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

Installation

If you haven’t already, set up the Amazon Web Services integration first. Enabling the Amazon RDS integration is also required.

Metric collection

  1. In the AWS integration page, ensure that RDS Proxy is enabled under the Metric Collection tab.
  2. Install the Datadog - Amazon RDS Proxy integration.

Log collection

Enable logging

When creating an RDS Proxy, logging can be enabled in the advanced configuration. Follow instructions in Getting started with RDS Proxy to start sending your RDS Proxy logs to Cloudwatch.

Send logs to Datadog

  1. If you haven’t already, set up the Datadog log collection AWS Lambda function.
  2. 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 to analyze your logs.

Data Collected

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

The Amazon RDS Proxy integration does not include any events.

Service Checks

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

Troubleshooting

Need help? Contact Datadog support.

PREVIEWING: may/unit-testing