Installing Metric Collection Plug-ins

Direct Connect plug-ins monitor network quality of connections along with two key metrics of remote subnets: network latency and packet loss rate.

There are two plug-ins:

dc-nqa-collector: monitors the connections requested using the Direct Connect console.
history-dc-nqa-collector: monitors historical connections.

Automated connections are requested using the console and can be self-service or 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 configured manually. Historical connections exist only in some regions.

Constraints

The plug-ins can only be installed on Linux ECSs that are in the same VPC as the connection.

Prerequisites

Cloud Eye is available in the region.

Procedure

Install the Agent provided by Cloud Eye for server monitoring.
1. Log in to the management console.
2. Under Management & Deployment, select Cloud Eye.
3. In the navigation pane on the left, choose Server Monitoring > Elastic Cloud Server.
4. Click Install and configure the Agent.
5. Select the Agent based on the server type.
  (x86 servers with image version of 7.0 or later are recommended.)
6. Copy the installation command and run it on the server.
  
  If "Telescope process starts successfully" is displayed, the Agent has been installed.
Upload the plug-ins to an OBS bucket.
1. Log in to the management console.
2. Choose Service List > Storage > Object Storage Service.
3. Click Create Bucket.
4. Configure the parameters.
  Enter a bucket name and set Bucket Policy to Public Read.
  
  The public read permission allows any user to read objects in the bucket without identity authentication. To ensure data security, change the bucket policy to Private after configuring the plug-ins.
5. Click Create Now.
6. Click the name of the created bucket in the bucket list.
7. On the Overview page of the bucket, copy the access domain name.
8. In the navigation pane on the left, click Objects.
9. On the Objects page, click Upload Object.
10. Decompress the dc_plugins_x86.rar and upload the decompressed file to the OBS bucket.
Use the one-click installation script dc-installer.sh to configure the plug-ins.
1. Log in to the ECS as user root.
2. Create the user.txt file in the usr/local/ directory and add user information to the file.
```
cd /usr/local/
vi user.txt
```
  The user.txt file contains the path of the plug-ins in the OBS bucket, resource ID, and remote IP address.
  - Path of the plug-ins in the OBS bucket: Select dc-nqa-collector for automated connections. Select history-dc-nqa-collector for historical connections. The path is in the following format:
    https://cesplugin.obs.xxx.edu.cn/dc-nqa-collector
  - Information about monitored resources: Each resource occupies a line, and consists of a resource ID and a remote IP address separated from the resource ID by a comma (,). To add multiple resources, add lines in the same format, as shown below:
    75e09ecf-xxxx-xxxx-xxx-e1295e03e5dc,x.x.x.x
    - Resource ID: If dc-nqa-collector is used, resource ID is the virtual interface ID, which can be queried on the Virtual Interfaces page of the Direct Connect console. If history-dc-nqa-collector is used, resource ID is the historical connection ID, which can be queried on the Historical Connections page of the Direct Connect console.
    - Remote IP address: the IP address of the remote gateway or an IP address in the remote subnet, which will be used to ping an IP address in the VPC. If dc-nqa-collector is used, you can query the IP address of the remote gateway on the Virtual Interfaces page. If history-dc-nqa-collector is used, you can query the IP address in the remote subnet on the Historical Connections page.
      
      Ensure that each resource ID matches one remote IP address. You cannot enter multiple IP addresses or CIDR blocks.
      
      After the plug-ins are installed, if you want to add more resources for monitoring, edit the user.txt file by adding new IDs and IP addresses in sequence, and then perform 3.c.
3. Execute the one-click installation script.
  The path in the command is where the script is stored in the OBS bucket.
  
  The following is an example command.
```
cd /usr/local && wget --no-check-certificate https://xxxx.cn/dc-installer.sh && chmod 755 dc-installer.sh && ./dc-installer.sh
```

View monitoring information.
1. Log in to the management console.
2. Under Management & Deployment, select Cloud Eye.
3. In the navigation pane on the left, choose Server Monitoring > Elastic Cloud Server.
  Ensure that the Agent is in the Running state.
4. In the navigation pane on the left, choose Cloud Service Monitoring > Direct Connect.
5. Click the name of the monitored object to view the network latency and packet loss rate.