Help Center/ Cloud Eye/ User Guide/ Server Monitoring/ Installing the Direct Connect Metric Collection Plug-ins
Updated on 2023-02-27 GMT+08:00

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

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

In some regions of Huawei Cloud, 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

    The content of the user.txt file 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 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

    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-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

    LA-Mexico City2: https://uniagent-la-north-2.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-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

    LA-Mexico City2: https://uniagent-la-north-2.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 plug-in script.

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

    bash dc-installer.sh

    Figure 2 Successful installation
  5. 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