Amazon Direct Connect
Security Monitoring is now available Security Monitoring is now available

Amazon Direct Connect

Crawler Crawler

Overview

This integration collects metrics from AWS Direct Connect (e.g. Connection state, bit rate ingress and egress, packet rate ingress and egress, and more).

Setup

Installation

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

Metric collection

  1. In the AWS integration tile, ensure that DirectConnect is checked under metric collection.

  2. Add those permissions to your Datadog IAM policy in order to collect Amazon Direct Connect metrics:

    • directconnect:DescribeConnections: Used to list available Direct Connect connections.
    • directconnect:DescribeTags: Used to gather custom tags applied to Direct Connect connections.

    For more information on Direct Connect policies, review the documentation on the AWS website.

  3. Install the Datadog - AWS Direct Connect integration.

Log collection

Enable logging

Configure Amazon Direct Connect to send logs either to a S3 bucket or to Cloudwatch.

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

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 S3 bucket or Cloudwatch log group that contains your Amazon Direct Connect logs in the AWS console:

Data Collected

Metrics

aws.dx.connection_state
(gauge)		The state of the connection. 0 indicates DOWN and 1 indicates UP.
aws.dx.connection_bps_egress
(rate)		The bit rate for outbound data from the AWS side of the connection.
Shown as bit
aws.dx.connection_bps_ingress
(rate)		The bit rate for inbound data to the AWS side of the connection.
Shown as bit
aws.dx.connection_pps_egress
(rate)		The packet rate for outbound data from the AWS side of the connection.
Shown as packet
aws.dx.connection_pps_ingress
(rate)		The packet rate for inbound data to the AWS side of the connection.
Shown as packet
aws.dx.connection_crcerror_count
(count)		The number of times cyclic redundancy check (CRC) errors are observed for the data received at the connection.
Shown as error
aws.dx.connection_light_level_tx
(gauge)		Indicates the health of the fiber connection for egress (outbound) traffic from the AWS side of the connection.
aws.dx.connection_light_level_rx
(gauge)		Indicates the health of the fiber connection for ingress (inbound) traffic to the AWS side of the connection.

Each of the metrics retrieved from AWS will be assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.

Events

The AWS Direct Connect integration does not include any events.

Service Checks

The AWS Direct Connect integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.

On this Page