Help Center> Cloud Eye> User Guide> Server Monitoring> Installing the Direct Connect Metric Collection Plug-ins

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-ins support only the Linux OS. ECSs where the plug-ins are to be installed must be in the same VPC as the connection.

Prerequisites

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

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

  1. Log in to an ECS as user root.
  2. 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

    user.txt is in the following format:

    Figure 1 Example of format

    Parameter descriptions are as follows.

    1. 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.
    2. Information about monitored resources: One monitored resource occupies one line, and consists of a resource ID and a remote IP address that are separated by a comma (,). To add multiple resources, add lines in the same format.
      • Resource ID: The value 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 plug-in is installed, if you want to add resources to be monitored, you only need to edit the user.txt file and add the corresponding ID and IP address in sequence.
    Table 1 Obtaining the plug-in installation package

    Name

    Download Path

    dc-nqa-collector installation package

    CN North-Beijing4: https://uniagent-cn-north-4.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    CN North-Beijing1: https://uniagent-cn-north-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    CN East-Shanghai1: https://uniagent-cn-east-3.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    CN East-Shanghai2: https://uniagent-cn-east-2.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    CN South-Guangzhou: https://uniagent-cn-south-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    CN Southwest-Guiyang1: https://uniagent-cn-southwest-2.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    AP-Hong-Kong: https://uniagent-ap-southeast-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    AP-Bangkok: https://uniagent-ap-southeast-2.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    AP-Singapore: https://uniagent-ap-southeast-3.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    Africa-Johannesburg: https://uniagent-af-south-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    LA-Sao Paulo1: https://uniagent-sa-brazil-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    LA-Santiago: https://uniagent-la-south-2.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    LA-Mexico City 1: https://uniagent-na-mexico-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector

    history-dc-nqa-collector installation package

    CN North-Beijing4: https://uniagent-cn-north-4.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    CN North-Beijing1: https://uniagent-cn-north-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    CN East-Shanghai1: https://uniagent-cn-east-3.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    CN East-Shanghai2: https://uniagent-cn-east-2.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    CN South-Guangzhou: https://uniagent-cn-south-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    CN Southwest-Guiyang1: https://uniagent-cn-southwest-2.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    AP-Hong-Kong: https://uniagent-ap-southeast-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    AP-Bangkok: https://uniagent-ap-southeast-2.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    AP-Singapore: https://uniagent-ap-southeast-3.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    Africa-Johannesburg: https://uniagent-af-south-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    LA-Sao Paulo1: https://uniagent-sa-brazil-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    LA-Santiago: https://uniagent-la-south-2.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

    LA-Mexico City 1: https://uniagent-na-mexico-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector

  3. Download the one-click installation script to the usr/local/ directory.
  4. Run the following command to run the one-click installation script of the plug-in.

    If the installation is successful, the information shown in Figure 2 is displayed.

    bash dc-installer.sh

    Figure 2 Successful installation
  5. After the Agent is installed, wait for about 1 minute, log in to the management console, and view the Direct Connect monitoring data.

    Under Management & Deployment, 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