Installing the Direct Connect Metric Collection Plug-ins

The Direct Connect plug-ins detect the end-to-end network quality of connections, and mainly monitor two metrics of remote subnets: network latency and packet loss rate.

There are two types of Direct Connect plug-ins:

dc-nqa-collector: monitors the connections created on the Direct Connect console.
history-dc-nqa-collector: monitors connections created through self-service.

Automated connections are requested by yourself on the console and are classified into self-service connections and full-service connections. Each connection has at least a virtual gateway and a virtual interface, and their routes are automatically advertised. Connections in most regions are automated connections.
Historical connections are requested by email or phone. They do not have virtual gateways and virtual interfaces, and their routes must be manually configured. Historical connections exist only in some regions.

Constraints

The plug-in supports only Linux.

Prerequisites

You have installed the Cloud Eye Agent. For details, see Agent Installation and Configuration.
The Agent has been restored. For details, see Restoring the Agent Configurations on a Linux Server.
You have obtained the password of user root for logging in to the target ECS.

Using the One-Click Installation Script to Configure the Plug-ins

In some regions of cloud services, you can use the one-click installation script to configure the plug-ins. Table 2 lists the supported regions.

Run the following command to create the user.txt file in the usr/local/ directory and add user information, including the plug-in download link, monitored resource ID, and remote IP address:

cd /usr/local/

vi user.txt

Figure 1 shows the format of the content in the user.txt file.

Figure 1 Example of format

Parameter descriptions are as follows.

Plug-in download link: To monitor the connections created on the Direct Connect console, select the dc-nqa-collector plug-in. To monitor the connections created through self-service, select the history-dc-nqa-collector plug-in. For details about the download address of the installation package in each region, see Table 1.
Information about monitored resources: One resource occupies one line, and consists of a resource ID and a remote IP address. Use a comma (,) to separate the resource ID and remote IP address. To add multiple resources, add lines in the same format.
- Resource ID: The ID must contain 32 characters, including letters and digits, for example, b95b9fdc-65de-44db-99b1-ed321b6c11d0 or b95b9fdc65de44db99b1ed321b6c11d0.
  - If the dc-nqa-collector plug-in is used, the resource ID is the virtual interface ID, which can be queried on the Virtual Interfaces page of the Direct Connect console.
  
  - If the history-dc-nqa-collector plug-in is used, the resource ID is the ID of the connection created through self-service, which can be queried on the Historical Connections page of the Direct Connect console.
- Remote IP address: indicates the remote IP address that needs to be pinged with the VPC. Generally, it is the remote gateway IP address.
  - If the dc-nqa-collector plug-in is used, enter the IP address of the remote gateway, which can be obtained on the Virtual Gateways page of the Direct Connect console.
  
  - If the history-dc-nqa-collector plug-in is used, enter the host address in the Remote Subnet column on the Historical Connections page of the Direct Connect console.

Ensure that each monitored resource ID matches one remote IP address. You are not allowed to enter multiple IP addresses nor CIDR blocks.
After the Agent is installed, if you want to add more resources to be monitored, edit the user.txt file by adding new IDs and IP addresses in sequence, and then perform 4.

**Table 1** Obtaining the plug-in installation package
Name	Download Path
dc-nqa-collector installation package	ae-ad-1: https://uniagent-ae-ad-1.obs.ae-ad-1.g42cloud.com/extension/dc/dc-nqa-collector
history-dc-nqa-collector installation package	ae-ad-1: https://uniagent-ae-ad-1.obs.ae-ad-1.g42cloud.com/extension/dc/history-dc-nqa-collector

Download the one-click installation script to the /usr/local/ directory.

wget Download path of the target region

**Table 2** One-click installation script of the Direct Connect plug-ins
Region	Download Path
ae-ad-1	https://uniagent-ae-ad-1.obs.ae-ad-1.g42cloud.com/extension/dc/dc-installer.sh

Run the following command to run the plug-in script.
If the installation is successful, the information shown in Figure 2 is displayed.

bash dc-installer.sh

Figure 2 Successful installation
Wait for about 1 minute after installation and view the Direct Connect monitoring data on the Cloud Eye console.
Click Service List, and select Cloud Eye. In the navigation pane on the left, choose Cloud Service Monitoring > Direct Connect. You can click the name of a monitored object to view the latency and packet loss rate.

Figure 3 Network latency and packet loss rate