# 安装云专线指标采集插件
#### 应用场景
云专线指标采集插件是用于监测云专线端到端网络质量的插件， 插件需要部署在专线接入VPC内的ECS中，默认每秒从ECS向本地IDC（Internet Data Center）的远端IP发送Ping报文，通过Ping报文的响应结果，计算出云专线端到端的网络时延和丢包率，并将网络时延和丢包率指标上报给云监控服务。
云专线指标采集插件分为两种：
- **dc-nqa-collector** ：用于监控自动化专线，探测远端子网的时延和丢包率。
  若您的云专线资源包含物理连接、虚拟网关和虚拟接口，则该云专线为自动化专线，路由配置支持自动下发。目前大多数区域的云专线都属于自动化专线，可在[云专线控制台](https://console.huaweicloud.com/vpc/#/dc/phydline)查看。
  
- **history-dc-nqa-collector** ：用于监控手工专线，探测远端子网的时延和丢包率。
  若您的云专线资源只有物理连接，不包含虚拟网关和虚拟接口，则该云专线为手工专线，需要手工配置路由等信息。目前仅部分区域的存量资源属于手工专线，可在[云专线历史信息列表页](https://console.huaweicloud.com/vpc/#/dc/dline)查看。
  
 
#### 监控指标
云专线指标采集插件主要用于监测**时延** 和**丢包率**两个指标。
表1网络质量监控指标 
| 指标ID | 指标名称 | 指标含义 | 取值范围 | 单位 | 进制    | 测量对象（维度） | 监控周期 |
|:---|:---|:---|:---|:---|:---|:---|:---|
| latency                     | 时延                            | 云专线的网络时延。                    | ≥ 0                          | ms | 不涉及   | 虚拟接口和历史物理连接                    | 1分钟  |
| packet_loss_rate              | 丢包率                         | 云专线的丢包率。                     | 0\~100                       | % | 不涉及 | 虚拟接口和历史物理连接                      | 1分钟  |
   
#### 约束和限制
云专线指标采集插件目前仅支持安装在**Linux x86架构的操作系统**的弹性云服务器中。操作系统建议使用CentOS，主机规格选择"2vCPUs \| 4GiB"或更高配置。
#### 前提条件
- 已创建用于部署云专线指标采集插件的弹性云服务器，并获取root密码。 建议在每个专线接入的VPC中新增一台ECS，用于部署云专线指标采集插件，不和其他业务的ECS混用。自动化专线接入的VPC可在[云专线虚拟网关列表页](https://console.huaweicloud.com/vpc/#/dc/vgw)查看关联的VPC，手工专线接入的VPC可在[云专线历史信息列表页](https://console.huaweicloud.com/vpc/#/dc/dline)查看关联的VPC。
  
- 已为当前区域的主机授予插件权限，配置方式请参见[通过一键配置为主机授予插件权限](https://support.huaweicloud.com/usermanual-ces/ces_01_0028.html)。
- 已完成云监控主机监控Agent的安装，详细请参见[Agent安装](https://support.huaweicloud.com/usermanual-ces/ces_01_0029.html)。
 
#### 安装云专线指标采集插件
目前部分区域支持使用一键安装脚本安装云专线指标采集插件，支持的区域请参见[表4]。
![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/note_3.0-zh-cn.png)
如果您的专线资源所在区域不支持通过一键安装脚本安装云专线指标采集插件，请[提交工单](https://console.huaweicloud.com/ticket/?locale=zh-cn#/ticketindex/serviceTickets)或者联系您的客户经理提供插件采集安装包并指导您完成安装。
1. 使用root账号登录用于部署插件的ECS。
2. 执行以下命令，在"/usr/local/"目录下新建"user.txt"文件并添加用户信息，包括插件的下载链接、监控资源ID和远端IP。
   ```
   cd /usr/local/
   vi user.txt
   ```
   "user.txt"文件内容格式示例如下所示。
   ```
   https://uniagent-xx-xxx-x.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector  //插件的下载链接
   9dbe3905-935f-4c7b-bc41-d33a963d57d4,X.X.X.X    //监控资源ID1,远端IP1（一般为远端网关的IP）
   b95b9fdc-65de-44db-99b1-ed321b6c11d0,X.X.X.X    //监控资源ID2,远端IP2（一般为远端网关的IP）
   ```
   表2用户信息参数说明 
   | 用户信息  | 信息说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   |:---|:---|
   | 插件下载链接 | - 若监控自动化专线，请选择dc-nqa-collector插件。  - 若监控手工专线，请选择history-dc-nqa-collector插件。   各区域的插件安装包下载链接请参见[表3]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   | 监控资源信息  | 一条监控资源占据一行，由资源ID和远端IP组成，使用","隔开。 注意： - 请确保每条监控资源的资源ID与远端IP一一对应，不支持一个资源ID对应填写多个IP或网段。  - 若有多条云专线资源需要进行监控，需添加多条资源，以同样的格式依次新增一行监控资源信息。   - 资源ID：由32位字母或数字组成，格式如"b95b9fdc-65de-44db-99b1-ed321b6c11d0"或"b95b9fdc65de44db99b1ed321b6c11d0"。 - 若监控自动化专线，则资源ID为虚拟接口ID。 登录[云专线虚拟接口列表页](https://console.huaweicloud.com/vpc/?#/dc/vif/list)，在虚拟接口列表"名称/ID"中可获取虚拟接口ID。   - 若监控手工专线，则资源ID为手工专线ID。 登录[云专线历史信息列表页](https://console.huaweicloud.com/vpc/?#/dc/dline)，在历史信息列表"名称"中可获取手工专线ID。     - 远端IP：需要与VPC互ping的远端地址，一般为远端网关的IP。 - 若监控自动化专线，一般填写远端网关地址。 登录[云专线虚拟接口列表页](https://console.huaweicloud.com/vpc/?#/dc/vif/list)，单击需要查看的虚拟接口名称，查看虚拟接口对等体列表中的"远端网关（用户侧）"，即为远端网关地址。   - 若监控手工专线，可填写远端子网中的主机地址。 登录[云专线历史信息列表页](https://console.huaweicloud.com/vpc/?#/dc/dline)，在历史信息列表查看"远端子网"，即为远端子网中的主机地址。      |
      
    表3插件安装包获取路径 
   | 名称   | 下载路径                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   |:---|:---|
   | dc-nqa-collector插件安装包        | 华北-北京四：<https://uniagent-cn-north-4.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 华北-北京一：<https://uniagent-cn-north-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 华东-上海一：<https://uniagent-cn-east-3.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 华东-上海二：<https://uniagent-cn-east-2.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 华南-广州：<https://uniagent-cn-south-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 西南-贵阳一：<https://uniagent-cn-southwest-2.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 华东-青岛：<https://uniagent-cn-east-5.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 华南-深圳：<https://uniagent-cn-south-2.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 中国-香港：<https://uniagent-ap-southeast-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 亚太-曼谷：<https://uniagent-ap-southeast-2.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 亚太-新加坡：<https://uniagent-ap-southeast-3.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 亚太-雅加达：<https://uniagent-ap-southeast-4.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 非洲-约翰内斯堡：<https://uniagent-af-south-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 拉美-圣保罗一：[https://uniagent-sa-brazil-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector](https://uniagent-af-south-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector) 拉美-圣地亚哥：<https://uniagent-la-south-2.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 拉美-墨西哥城一：<https://uniagent-na-mexico-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 拉美-墨西哥城二：<https://uniagent-la-north-2.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 亚太-马尼拉：<https://uniagent-ap-southeast-5.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 土耳其-伊斯坦布尔：<https://uniagent-tr-west-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 拉美-布宜诺斯艾利斯一：<https://uniagent-sa-argentina-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> 拉美-利马一：<https://uniagent-sa-peru-1.obs.myhuaweicloud.com/extension/dc/dc-nqa-collector> |
   | history-dc-nqa-collector插件安装包 | 华北-北京四：<https://uniagent-cn-north-4.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 华北-北京一：<https://uniagent-cn-north-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 华东-上海一：<https://uniagent-cn-east-3.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 华东-上海二：<https://uniagent-cn-east-2.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 华南-广州：<https://uniagent-cn-south-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 西南-贵阳一：<https://uniagent-cn-southwest-2.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 中国-香港：<https://uniagent-ap-southeast-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 亚太-曼谷：<https://uniagent-ap-southeast-2.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 亚太-新加坡：<https://uniagent-ap-southeast-3.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 亚太-雅加达：<https://uniagent-ap-southeast-4.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 非洲-约翰内斯堡：<https://uniagent-af-south-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 拉美-圣保罗一：<https://uniagent-sa-brazil-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 拉美-圣地亚哥：<https://uniagent-la-south-2.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 拉美-墨西哥城一：<https://uniagent-na-mexico-1.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector> 拉美-墨西哥城二：<https://uniagent-la-north-2.obs.myhuaweicloud.com/extension/dc/history-dc-nqa-collector>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
      
   
3. 执行以下命令，下载一键安装脚本到"/usr/local/"目录下。
   ```
   wget 一键安装脚本获取路径
   ```
    表4一键安装脚本获取路径 
   | 一键安装脚本支持区域 | 下载路径                                                                                  |
   |:---|:---|
   | 华北-北京四     | <https://uniagent-cn-north-4.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>        |
   | 华北-北京一    | <https://uniagent-cn-north-1.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>       |
   | 华东-上海一      | <https://uniagent-cn-east-3.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>         |
   | 华东-上海二    | <https://uniagent-cn-east-2.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>         |
   | 华南-广州   | <https://uniagent-cn-south-1.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>       |
   | 西南-贵阳一      | <https://uniagent-cn-southwest-2.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>  |
   | 华东-青岛                                                                                             | <https://uniagent-cn-east-5.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>                                                                                                 |
   | 华南-深圳                                                                                            | <https://uniagent-cn-south-2.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>                                                                                              |
   | 中国-香港      | <https://uniagent-ap-southeast-1.obs.myhuaweicloud.com/extension/dc/dc-installer.sh> |
   | 亚太-曼谷     | <https://uniagent-ap-southeast-2.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>      |
   | 亚太-新加坡    | <https://uniagent-ap-southeast-3.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>   |
   | 亚太-雅加达                                                                                             | <https://uniagent-ap-southeast-4.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>                                                                                           |
   | 非洲-约翰内斯堡  | <https://uniagent-af-south-1.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>        |
   | 拉美-圣保罗一     | <https://uniagent-sa-brazil-1.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>       |
   | 拉美-圣地亚哥     | <https://uniagent-la-south-2.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>         |
   | 拉美-墨西哥城一   | <https://uniagent-na-mexico-1.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>       |
   | 拉美-墨西哥城二  | <https://uniagent-la-north-2.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>       |
   | 亚太-马尼拉                                                                                            | <https://uniagent-ap-southeast-5.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>                                                                                          |
   | 土耳其-伊斯坦布尔                                                                                         | <https://uniagent-tr-west-1.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>                                                                                                |
   | 拉美-布宜诺斯艾利斯一                                                                                     | <https://uniagent-sa-argentina-1.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>                                                                                         |
   | 拉美-利马一                                                                                           | <https://uniagent-sa-peru-1.obs.myhuaweicloud.com/extension/dc/dc-installer.sh>                                                                                               |
      
   
4. 执行以下命令，安装插件，安装成功的信息如[图1]所示。
   ```
   bash dc-installer.sh
   ```
   图1安装成功   
   ![](https://support.huaweicloud.com/usermanual-ces/zh-cn_image_0000002666348144.png)
   ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/note_3.0-zh-cn.png)
   安装完成之后，如需继续添加监控资源，请编辑"user.txt"文件，新增行填写资源ID和远端IP信息，并重新执行[3]和[4]。
   
5. 安装成功后，等待云专线资源同步，预计需要1小时左右。
 
#### 查看监控指标
云专线资源同步完成后，您可以在云监控服务控制台查看时延和丢包率的监控指标信息。
1. 登录[云监控服务控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。
2. 在左侧导航，选择"云服务监控"。
3. 在云服务看板列表中，单击云专线看板名称"云专线 DCAAS"。
4. 在云服务监控详情页面：
   - 如需查看自动化专线监控指标，在云专线右侧的下拉框中选择"虚拟接口"。
   
   - 如需查看手工专线监控指标，在云专线右侧的下拉框中选择"历史专线"
    
5. 在实例列表中，单击实例所在行"操作"列的"查看监控指标"，查看资源的监控信息。 ![](https://support.huaweicloud.com/usermanual-ces/zh-cn_image_0000002666508052.png "点击放大")
   
   
 
