AWS Direct Connect
Collect asset and monitoring data for AWS Direct Connect connections and virtual interfaces.
Configuration¶
Install Func¶
We recommend enabling hosted Func under Guance Integrations - Extensions. All prerequisites are installed automatically; continue with the script installation.
To deploy Func yourself, see Deploy Func Yourself
Install Script¶
Note: Prepare an Amazon AK that meets the requirements. For simplicity, you can grant the global read-only permission
ReadOnlyAccessdirectly.
Activate the Hosted Script¶
- Log in to the Guance console.
- Click 【Integrations】 and select 【Cloud Account Management】.
- Click 【Add Cloud Account】, select 【AWS】, and enter the required information. Skip this step if the cloud account has already been configured.
- Click 【Test】, then click 【Save】 if the test succeeds. If it fails, check the configuration and test again.
- Find the added cloud account in 【Cloud Account Management】 and click it to open its details page.
- Click 【Integrations】 on the cloud account details page, find
AWS Direct ConnectunderNot Installed, and click 【Install】. Complete the installation in the dialog.
Activate the Script Manually¶
-
Log in to the Func console, click 【Script Market】, open the Guance script market, and search for
integration_aws_direct_connect. -
Click 【Install】 and enter AWS AK ID, AK Secret, and the account name.
-
Click 【Deploy Startup Script】. The system automatically creates the
Startupscript set and configures the startup script. -
After activation, find the automatic trigger configuration under 「Management / Automatic Trigger Configuration」. Click 【Execute】 to run it immediately without waiting for the schedule. After a short wait, review the task records and logs.
Verification¶
- In "Management / Automatic Trigger Configuration", confirm that the task has a corresponding automatic trigger configuration. Check the task records and logs for errors.
- In Guance, open "Infrastructure / Custom" to view
aws_dx_connectconnection objects andaws_dx_virtual_interfacevirtual interface objects. - In Guance, open "Metrics" to check for the corresponding monitoring data.
Metrics¶
Configure Amazon CloudWatch to collect additional metrics. See Amazon CloudWatch metric details
AWS Direct Connect metrics are stored in the aws_dx measurement. The description column describes each metric, including its unit and statistic.
| MetricName | MetricDescribe | Dimensions | Unit |
|---|---|---|---|
connection_state_minimum |
Connection state: 1 indicates up and 0 indicates down | connection_id | - |
connection_bps_egress_average |
Bit rate of traffic leaving the AWS side of the connection | connection_id | bps |
connection_bps_ingress_average |
Bit rate of traffic entering the AWS side of the connection | connection_id | bps |
connection_pps_egress_average |
Packet rate of traffic leaving the AWS side of the connection | connection_id | pps |
connection_pps_ingress_average |
Packet rate of traffic entering the AWS side of the connection | connection_id | pps |
connection_error_count_sum |
Total MAC-layer errors recorded by the AWS device, including CRC errors | connection_id | count |
connection_light_level_tx_average |
Optical transmit power on the AWS side of the connection | connection_id, optical_lane_number | dBm |
connection_light_level_rx_average |
Optical receive power on the AWS side of the connection | connection_id, optical_lane_number | dBm |
connection_encryption_state_minimum |
Connection encryption state: 1 indicates normal and 0 indicates abnormal; 0 if any connection in the LAG has an encryption issue | connection_id | - |
connection_discards_pps_egress_average |
Rate of packets discarded when leaving the AWS side of the connection | connection_id | pps |
virtual_interface_bps_egress_average |
Bit rate of traffic leaving the AWS side of the virtual interface | connection_id, virtual_interface_id | bps |
virtual_interface_bps_ingress_average |
Bit rate of traffic entering the AWS side of the virtual interface | connection_id, virtual_interface_id | bps |
virtual_interface_pps_egress_average |
Packet rate of traffic leaving the AWS side of the virtual interface | connection_id, virtual_interface_id | pps |
virtual_interface_pps_ingress_average |
Packet rate of traffic entering the AWS side of the virtual interface | connection_id, virtual_interface_id | pps |