インテグレーションバージョン2.0.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [email protected].

このページは日本語には対応しておりません。随時翻訳に取り組んでいます。
翻訳に関してご質問やご意見ございましたら、お気軽にご連絡ください

Overview

This integration collects metrics from AWS Direct Connect, such as 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 page, ensure that DirectConnect is enabled under the Metric Collection tab.

  2. Add those permissions to your Datadog IAM policy in order to collect AWS 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, see the Direct Connect policies on the AWS website.

  3. Install the Datadog - AWS Direct Connect integration.

Log collection

Enable logging

Configure AWS 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 Forwarder Lambda function.

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

Data Collected

Metrics

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_crcerror_count
(count)
The total count of cyclic redundancy check (CRC) errors on the connection. Deprecated — use aws.dx.connection_error_count instead.
Shown as error
aws.dx.connection_discards_pps_egress
(rate)
The packet discard rate for outbound data from the AWS side of the connection, due to buffer overflows, interface congestion, or other network conditions.
Shown as packet
aws.dx.connection_encryption_state
(gauge)
The encryption status of the connection. 1 indicates encryption is up, 0 indicates encryption is down. For LAG connections, 1 indicates all connections have encryption up.
aws.dx.connection_error_count
(count)
The total count of all MAC level errors recorded since the last reported data point, including cyclic redundancy check (CRC) errors.
Shown as error
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.
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_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_state
(gauge)
The state of the connection. 1 indicates up and 0 indicates down.
aws.dx.virtual_interface_bgp_prefixes_accepted
(gauge)
The number of BGP prefixes accepted from the BGP peer on the virtual interface.
aws.dx.virtual_interface_bgp_prefixes_advertised
(gauge)
The number of BGP prefixes advertised to the BGP peer on the virtual interface.
aws.dx.virtual_interface_bgp_status
(gauge)
The state of the BGP peering session for the virtual interface. 1 indicates up and 0 indicates down.
aws.dx.virtual_interface_bps_egress
(rate)
The bitrate for outbound data from the AWS side of the virtual interface.
Shown as bit
aws.dx.virtual_interface_bps_ingress
(rate)
The bitrate for inbound data to the AWS side of the virtual interface.
Shown as bit
aws.dx.virtual_interface_policed_bps_egress
(rate)
The number of bytes per second traveling from AWS to your on-premises network that were dropped by the Rate Limiter when exceeding the allocated bandwidth.
Shown as bit
aws.dx.virtual_interface_policed_bps_ingress
(rate)
The number of bytes per second traveling from your on-premises network to AWS that were dropped by the Rate Limiter when exceeding the allocated bandwidth.
Shown as bit
aws.dx.virtual_interface_policed_pps_egress
(rate)
The number of packets per second traveling from AWS to your on-premises network that were dropped by the Rate Limiter when exceeding the allocated bandwidth.
Shown as packet
aws.dx.virtual_interface_policed_pps_ingress
(rate)
The number of packets per second traveling from your on-premises network to AWS that were dropped by the Rate Limiter when exceeding the allocated bandwidth.
Shown as packet
aws.dx.virtual_interface_pps_egress
(rate)
The packet rate for outbound data from the AWS side of the virtual interface.
Shown as packet
aws.dx.virtual_interface_pps_ingress
(rate)
The packet rate for inbound data to the AWS side of the virtual interface.
Shown as packet
aws.dx.virtual_interface_utilization_egress
(gauge)
The percentage of bandwidth utilized for outbound data from the AWS side of the virtual interface.
Shown as percent
aws.dx.virtual_interface_utilization_ingress
(gauge)
The percentage of bandwidth utilized for inbound data to the AWS side of the virtual interface.
Shown as percent

Each of the metrics retrieved from AWS are 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.