AWS NAT Gateway

Overview

Use AWS NAT Gateway to enable instances in a private subnet to connect to the internet, but prevent the internet from initiating connections with the instances.

Enable this integration to see all your NAT Gateway metrics in Datadog.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

In the AWS integration page, ensure that NATGateway is enabled under the Metric Collection tab.
Install the Datadog - AWS NAT Gateway integration.

Log collection

Enable logging

Configure AWS NAT Gateway to send logs either to a S3 bucket or to CloudWatch.

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

Send logs to Datadog

If you haven’t already, set up the Datadog Forwarder Lambda function.
Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your AWS NAT Gateway logs in the AWS console:
- Add a manual trigger on the S3 bucket
- Add a manual trigger on the CloudWatch Log Group

Data Collected

Metrics

aws.natgateway.active_connection_count (count)	The total number of concurrent active TCP connections through the NAT gateway. Shown as connection
aws.natgateway.active_connection_count.maximum (count)	The maximum number of concurrent active TCP connections through the NAT gateway. Shown as connection
aws.natgateway.active_connection_count.minimum (count)	The minimum number of concurrent active TCP connections through the NAT gateway. Shown as connection
aws.natgateway.bytes_in_from_destination (gauge)	The number of bytes received by the NAT Gateway from the destination. Shown as byte
aws.natgateway.bytes_in_from_destination.sum (gauge)	The sum of bytes received by the NAT Gateway from the destination. Shown as byte
aws.natgateway.bytes_in_from_source (gauge)	The number of bytes received by the NAT Gateway from the VPC clients. Shown as byte
aws.natgateway.bytes_in_from_source.sum (gauge)	The sum of bytes received by the NAT Gateway from the VPC clients. Shown as byte
aws.natgateway.bytes_out_to_destination (gauge)	The number of bytes sent through the NAT Gateway to the destination. Shown as byte
aws.natgateway.bytes_out_to_destination.sum (gauge)	The sum of bytes sent through the NAT Gateway to the destination. Shown as byte
aws.natgateway.bytes_out_to_source (gauge)	The number of bytes sent through the NAT Gateway to the VPC clients. Shown as byte
aws.natgateway.bytes_out_to_source.sum (gauge)	The sum of bytes sent through the NAT Gateway to the VPC clients. Shown as byte
aws.natgateway.connection_attempt_count (count)	The number of connection attempts made through the NAT gateway. Shown as attempt
aws.natgateway.connection_attempt_count.sum (count)	The sum of connection attempts made through the NAT gateway. Shown as attempt
aws.natgateway.connection_established_count (count)	The number of connections established through the NAT gateway. Shown as connection
aws.natgateway.connection_established_count.sum (count)	The sum of connections established through the NAT gateway.
aws.natgateway.error_port_allocation (count)	The number of times the NAT gateway could not allocate a source port. Shown as error
aws.natgateway.error_port_allocation.sum (count)	The sum of times the NAT gateway could not allocate a source port. Shown as error
aws.natgateway.idle_timeout_count (count)	The number of timeouts caused by connections going from active to idle state. Shown as timeout
aws.natgateway.idle_timeout_count.sum (count)	The sum of timeouts caused by connections going from active to idle state. Shown as timeout
aws.natgateway.packets_drop_count (count)	The number of packets dropped by the NAT Gateway. Shown as packet
aws.natgateway.packets_drop_count.sum (count)	The sum of packets dropped by the NAT Gateway. Shown as packet
aws.natgateway.packets_in_from_destination (count)	The number of packets received by the NAT Gateway from the destination. Shown as packet
aws.natgateway.packets_in_from_destination.sum (count)	The sum of packets received by the NAT Gateway from the destination. Shown as packet
aws.natgateway.packets_in_from_source (count)	The number of packets received by the NAT Gateway from the VPC clients. Shown as packet
aws.natgateway.packets_in_from_source.sum (count)	The sum of packets received by the NAT Gateway from the VPC clients. Shown as packet
aws.natgateway.packets_out_to_destination (count)	The number of packets sent through the NAT Gateway to the destination. Shown as packet
aws.natgateway.packets_out_to_destination.sum (count)	The sum of packets sent through the NAT Gateway to the destination. Shown as packet
aws.natgateway.packets_out_to_source (count)	The number of packets sent through the NAT Gateway to the VPC clients. Shown as packet
aws.natgateway.packets_out_to_source.sum (count)	The sum of packets sent through the NAT Gateway to the VPC clients. Shown as packet

Events

The AWS NAT Gateway integration does not include any events.

Service Checks

The AWS NAT Gateway integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.