文档中心知识库API Explorer
文档中心›ZCF›ZStack Cloud›探索更多›SNMP管理使用教程ZCF
文档目录

概述

SNMP是简单网络管理协议，用于管理网络中的设备。ZStack Cloud提供SNMP管理功能，用户开启本功能并完成相关配置后，即可在第三方平台 (SNMP监控平台，如ZABBIX) 上获取ZStack Cloud上的资源监控数据，并接收从ZStack Cloud上推送的报警消息。

本文档将详细介绍SNMP功能开启和配置方法。

快速使用流程

SNMP获取监控数据

  1. 准备SNMP监控平台和MIB浏览器。
  2. 登录ZStack Cloud，开启SNMP管理，并配置相关参数。
  3. 下载并查看ZStack Cloud MIB文件。
  4. 登录SNMP监控平台，对接ZStack Cloud，并根据MIB文件添加监控条目。
  5. 在SNMP监控平台查看ZStack Cloud资源监控数据。

SNMP接收报警消息

  1. 准备SNMP监控平台，并配置Trap服务。
  2. 登录ZStack Cloud，开启SNMP管理，并添加SNMP Trap接收端。
  3. 创建SNMP Trap接收端类型的通知对象。
  4. 创建报警器并绑定SNMP Trap接收端通知对象。
  5. 登录SNMP监控平台，对接ZStack Cloud。
  6. 触发报警，SNMP监控平台可接收ZStack Cloud推送的报警消息。

典型场景实践

通过SNMP平台查看云平台资源监控

背景信息

使用SNMP协议，用户可通过第三方平台查看ZStack Cloud资源的监控数据，并接收ZStack Cloud推送的报警消息。本章主要介绍通过SNMP协议获取ZStack Cloud资源监控数据的方法。

目前，支持通过SNMP协议获取以下资源的监控数据：物理机、主存储、镜像服务器、云主机、VPC路由器。

本场景以对接ZABBIX平台为例进行介绍，用户也可选用其他SNMP平台。

配置信息

本场景基本配置信息如下：
ZStack Cloud信息 ZABBIX平台信息 SNMP协议信息
管理节点IP：172.26.51.91 服务器IP：172.26.51.240 协议类型：v2c
SNMP Agent端口：1161 团体字：v2c-test
具体实践流程如下：
  1. 准备ZABBIX平台和MIB Browser。
  2. 登录ZStack Cloud，启用SNMP管理。
  3. 下载ZStack Cloud MIB文件，查看资源监控项OID。
  4. 登录ZABBIX平台，对接ZStack Cloud。
  5. 在ZABBIX平台上添加监控项。
  6. 通过ZABBIX平台，查看ZStack Cloud资源监控数据。

操作步骤

  1. 准备ZABBIX平台和MIB Browser。
    1. 准备一个SNMP监控平台，该平台可通过SNMP协议获取云平台上的资源监控数据，本场景准备ZABBIX平台。
    2. 准备MIB Browser工具，用于查看ZStack Cloud MIB文件。可点击此处下载。
  2. 登录ZStack Cloud，启用SNMP管理。
    在ZStack Cloud主菜单，点击设置 > 平台设置 > SNMP管理，进入SNMP管理界面。在SNMP管理界面，点击去启用，进入启用SNMP管理界面。
    可参考以下示例输入相应内容：
    • SNMP Agent端口：配置在管理节点的端口，用于接收和响应来自ZABBIX的请求，默认为1161
    • SNMP协议类型：选择SNMP协议类型，支持v2c和v3两种类型，本场景下使用v2c协议
    • 团体字：设置一个团体字，用于ZABBIX和云平台间的认证对接，本场景下设置为v2c-test
    • SNMP Trap接收端：可选项，添加一个第三方服务器，用于接收云平台主动推送的报警消息，可在启用SNMP管理时添加，也可在启用完成后添加，本场景下，暂不添加SNMP Trap接收端
    如图 1所示：
    图 1. 启用SNMP管理


  3. 下载ZStack Cloud MIB文件，查看资源监控项OID。
    1. 在ZStack Cloud SNMP管理界面右上角，点击下载MIB文件，如图 2所示：
      图 2. 下载MIB文件


    2. 打开MIB Browser，在主菜单点击Advanced...，配置SNMP Agent信息，可参考以下示例输入相应内容：
      • Address：输入ZStack Cloud管理节点IP地址
      • Port：输入ZStack Cloud SNMP Agent端口，本场景下为1161
      • Read Community：输入在ZStack Cloud上设置的团体字，本场景下为v2c-test
      • Write Community：可留空不填
      • SNMP Version：选择ZStack Cloud上设置的SNMP协议类型，本场景下选择v2
      如图 3所示：
      图 3. 在MIB Browser配置SNMP Agent信息


    3. 在MIB Browser主菜单，点击File > Load MIBs，打开从ZStack Cloud下载的MIB文件。
      MIB文件中目前包含五类资源的监控项：物理机 (kvmHost)、主存储 (primaryStorage)、镜像服务器 (backupStorage)、云主机 (vm)、VPC路由器 (vRouter)。
    4. 展开资源类别文件夹，查看资源监控OID：
      资源监控OID由两部分组成：OID前缀和资源Index Value
      • OID前缀：OID前缀指向一个监控条目。在展开的MIB目录中，点击一个监控条目即可查看其对应的OID前缀。
      • 资源Index Value：Index Value指向被监控的具体资源，右击资源Table (例如：kvmHostTable)，选择Table View，即可在Index Value列查看各个资源的Index Value。
      • 示例：
        • 物理机内存空闲率 (memoryFreeInPercent)对应的OID前缀是.1.3.6.1.4.1.60687.1.1.101.101.1.25
        • 物理机A (UUID：bf6c3abe4fff41f5b6212d9a64fe2480) 对应的Index Value是49004.15038.20479.16885.46625.11674.25854.9344
        • 物理机B (UUID：d23cf9c3839c47a9af056fd3f0829f7f) 对应的Index Value是53820.63939.33692.18345.44805.28627.61570.40831
        • 监控物理机A内存空闲率的完整OID是：.1.3.6.1.4.1.60687.1.1.101.101.1.25.49004.15038.20479.16885.4
        • 监控物理机B内存空闲率的完整OID是：.1.3.6.1.4.1.60687.1.1.101.101.1.25.53820.63939.33692.18345.44805.28627.61570.40831
      如图 4、图 5、图 6所示：
      图 4. 监控条目对应的OID前缀


      图 5. 资源Index Value


      图 6. 完整OID


  4. 登录ZABBIX平台，对接ZStack Cloud。
    在ZABBIX主菜单，点击Configuration > Hosts，在Hosts界面，点击Create Host，进入New Host界面，将ZStack Cloud作为一个主机添加到ZABBIX。
    可参考以下信息输入相应内容：
    • Host Name：输入主机名称，本场景下设置为Cloud
    • Group：为主机选择分组
    • Interface：点击Add > SNMP，并设置以下参数：
      • IP address：输入ZStack Cloud管理节点IP
      • Connect to：选择Connect to IP
      • Port：输入在ZStack Cloud设置的SNMP Agent端口，本场景为1161
      • SNMP version：选择SNMP协议类型，需和ZStack Cloud上配置的一致，本场景选择SNMPv2
      • SNMP community：输入在ZStack Cloud上设置的团体字，本场景为v2c-test
      • 其他参数可按需设置
    如图 7所示：
    图 7. 在ZABBIX对接ZStack Cloud


    对接完成的ZStack Cloud将显示在ZABBIX Hosts列表中，等待几分钟，如Availability栏显示为绿色，则表示对接成功。
    如图 8所示：
    图 8. 成功对接ZStack Cloud


  5. 在ZABBIX平台上添加监控项。
    支持使用三种方式为ZABBIX对接ZStack Cloud监控项：对接单个资源监控项、对接批量资源监控项、导入全量资源监控项，推荐使用批量对接或全量导入方式。
    • 对接单个资源监控项：

      在ZABBIX主菜单，点击Configuration > Hosts，进入Hosts界面，选择刚刚添加的Host，点击Items列，进入Items界面，点击Create Item，添加监控项。

      使用该方法添加监控项，只能获取一个指定资源的指定监控数据，例如获取物理机A的内存空闲率，可参考以下示例输入相应内容：
      • Name：设置监控项名称，例如：物理机A的内存空闲率
      • Type：选择SNMP agent
      • Key：输入对应的监控项，例如：memoryFreeInPercent-HostA
      • Type of Information：选择Character
      • Host Interface：选择刚刚添加的Host IP地址和端口
      • SNMP OID：输入完整的OID，包括指向监控条目的OID前缀，和指向被监控资源的Index Value，例如，物理机A内存空闲率的OID：1.3.6.1.4.1.60687.1.1.101.101.1.25.49004.15038.20479.16885.46625.11674.25854.9344
      • Update Interval：设置监控数据更新间隔，ZABBIX会周期性从ZStack Cloud获取新的监控数据
      • 其他参数可按需设置
      图 9. 对接单个资源监控项


    • 对接批量资源监控项

      通过批量对接，ZABBIX可获取ZStack Cloud上一类或几类资源的监控数据，例如获取所有物理机的监控数据：

      1. 添加模板：

        在ZABBIX主菜单，点击Configuration > Templates，在Template界面，点击Create template，创建一个模板，本场景下，设置模板名称为For-Cloud

      2. 添加发现规则：
        在Template主列表，选择创建好的模板For-Cloud，在模板详情页菜单中，点击Discovery rules > Create discovery rule，添加发现规则，ZABBIX将根据发现规则，主动发现ZStack Cloud上的资源，可参考以下示例输入相应内容：
        • Name：输入发现规则名称，例如：discover-host，表示该规则用于发现物理机资源
        • Type：选择SNMP agent
        • Key：输入发现规则键值，例如：cloud.if.discovery
        • SNMP OID：输入一个易于识别的资源字段，ZABBIX将用该字段发现和标记资源。本场景下，使用资源UUID发现和标记物理机，输入以下内容：discovery[{#UUID},.1.3.6.1.4.1.60687.1.1.101.101.1.0]，其中，.1.3.6.1.4.1.60687.1.1.101.101.1.0是物理机UUID对应的OID前缀
        • Update Interval：设置ZABBIX自动发现ZStack Cloud的时间间隔
        • 其他参数可按需设置
        如图 10所示：
        图 10. 添加发现规则


        一个模板可以添加多条发现规则，用于发现ZStack Cloud上不同类别的资源，获取多个类别资源的监控数据。

      3. 添加监控项原型：

        在Template主列表，选择For-Cloud模板下从创建好的发现规则discover host，进入发现规则详情页，点击Item prototypes > Create item prototype，为发现规则添加监控项原型，ZABBIX会根据发现规则和监控项原型为ZStack Cloud上的资源自动、批量生成监控项。

        例如：批量生成物理机内存空闲率监控项，可参考以下示例输入相应内容：
        • Name：设置监控项名称模板，例如：物理机内存空闲率-{#UUID}，其中，{#UUID}由ZABBIX根据发现的资源自动填写
        • Type：选择SNMP agent
        • Key：设置监控项键值模板，例如：HostMemoryFreeInPercent-[{#UUID}]，其中，{#UUID}由ZABBIX根据发现的资源自动填写
        • Type of Information：选择Character
        • SNMP OID：设置资源监控OID模板，使用以下格式：OID前缀.{#SNMPINDEX}，OID前缀指向一个具体的监控条目，{#SNMPINDEX}由ZABBIX根据发现的资源自动填写，对应资源的Index Value。例如，获取物理机的内存空闲率，此处填写：.1.3.6.1.4.1.60687.1.1.101.101.1.25.{#SNMPINDEX}
        • Update Interval：设置监控数据更新间隔，ZABBIX会周期性从ZStack Cloud获取新的监控数据
        • 其他参数可按需设置
        如图 11所示：
        图 11. 添加监控项原型


        一个模板可添加多条监控项，获取多种监控数据，本场景添加了物理机内存空闲率、物理机内存空闲量、物理机内存已用率、物理机内存已用量，如图 12所示：
        图 12. 为发现规则添加多条监控项原型


      4. 将模板关联到主机
        在ZABBIX主菜单，点击Configuration > Host，在Host界面，点击ZStack Cloud对应的主机，进入编辑界面。在编辑界面，为主机选择刚刚创建的For-Cloud模板，如图 13所示：
        图 13. 将模板关联到主机


        绑定完成后，在ZABBIX主菜单，点击Configuration > Hosts，在Hosts界面，选择ZStack Cloud对应的主机，并查看其Items列，可以发现系统已根据模板发现规则和监控项原型，为ZStack Cloud中的每台物理机各生成了4条监控项。

        如图 14所示：
        图 14. 自动、批量生成监控项


      5. (可选) 导出已配置的模板。

        在ZABBIX主菜单，点击Configuration > Templates，在Template界面，选择创建好的模板For-Cloud，在界面下方点击Export，将配置好的模板导出为离线文件。

        该文件可以导入到其他ZABBIX平台，快速创建出相同的模板，简化手动配置流程。

    • 导入ZStack Cloud全量监控项
      1. 联系ZStack Cloud官方技术支持，获取全量SNMP监控项文件，该文件包含ZStack Cloud的全部SNMP监控项，可直接导入ZABBIX使用，无需手动配置模板和监控项原型。
        Note: 当前提供的全量监控项文件仅适用于ZABBIX 6.0版本。
      2. 在ZABBIX主菜单，点击Configurations > Templates，在Templates界面，点击Import，将获取的全量SNMP监控项文件导入。
      3. 在ZABBIX主菜单，点击Configuration > Host，在Host界面，点击ZStack Cloud对应的主机，进入编辑界面。在编辑界面，为主机选择刚刚导入的模板，模板名称为Cloud interfaces discovery all。
      4. 返回Host界面，选择ZStack Cloud对应的主机，点击Items，可以看到系统已根据导入模板，为主机生成全量监控项，如图 15所示：
        图 15. 生成全量监控项


  6. 通过ZABBIX平台，查看ZStack Cloud资源监控数据。
    在ZABBIX主菜单，点击Monitoring > Hosts，在Host界面，选择ZStack Cloud对应的主机，点击Latest Data，可以查看各个监控项的最新数据。
    如图 16所示：
    图 16. 查看各监控项最新数据




    点击监控项后的History列，还可以查看该监控项的历史数据。
    如图 17所示：
    图 17. 查看监控项历史数据




后续操作

至此，用户已成功在ZABBIX平台查看ZStack Cloud资源监控。获取ZABBIX平台更多使用方法，可参考ZABBIX官方文档。

通过SNMP平台接收云平台报警消息

背景信息

ZStack Cloud支持通过SNMP协议向第三方平台主动推送报警消息，本章主要介绍通过SNMP协议接收ZStack Cloud报警消息的方法。

本场景以对接ZABBIX平台为例进行介绍，用户也可选用其他SNMP平台。

配置信息

本场景基本配置信息如下：
ZStack Cloud信息 ZABBIX平台信息 SNMP协议信息
管理节点IP：172.26.51.205 服务器IP：172.26.51.240 协议类型：v2c
SNMP Agent端口：1161 SNMP Trap端口：162 团体字：v2c-test
具体实践流程如下：
  1. 准备ZABBIX平台。
  2. 登录ZStack Cloud，启用SNMP管理，并添加SNMP Trap接收端。
  3. 下载ZStack Cloud MIB文件。
  4. 配置ZABBIX服务器。
  5. 登录ZStack Cloud创建报警器，创建SNMP Trap接收端通知对象。
  6. 创建报警器并绑定SNMP Trap接收端通知对象。
  7. 登录ZABBIX平台，对接ZStack Cloud。
  8. 在ZABBIX平台上添加SNMP Trap监控项。
  9. 查看报警消息。

操作步骤

  1. 准备ZABBIX平台。
    准备一个SNMP监控平台，用于接收ZStack Cloud以Trap形式推送的报警消息，本场景以ZABBIX平台为例进行介绍，用户也可选用其他SNMP平台。
  2. 登录ZStack Cloud，启用SNMP管理。
    在ZStack Cloud主菜单，点击设置 > 平台设置 > SNMP管理，进入SNMP管理界面。在SNMP管理界面，点击去启用，进入启用SNMP管理界面。
    可参考以下示例输入相应内容：
    • SNMP Agent端口：配置在管理节点的端口，用于接收和响应来自ZABBIX的请求，默认为1161
    • SNMP协议类型：选择SNMP协议类型，支持v2c和v3两种类型，本场景下使用v2c协议
    • 团体字：设置一个团体字，用于ZABBIX和云平台间的认证对接，本场景下设置为v2c-test
    • SNMP Trap接收端：添加ZABBIX平台作为SNMP Trap接收端，接收ZStack Cloud推送的报警消息，请配置以下参数：
      • 名称：设置SNMP Trap接收端名称，本场景设置为SNMP Trap Receiver
      • IP地址：填写ZABBIX服务器IP地址
      • 端口号：填写ZABBIX服务器Trap消息接收端口，默认为162
    如图 18所示：
    图 18. 启用SNMP管理，添加SNMP Trap接收端


  3. 下载ZStack Cloud MIB文件。
    在ZStack Cloud SNMP管理界面右上角，点击下载MIB文件，如图 19所示：
    图 19. 下载MIB文件


  4. 配置ZABBIX服务器。
    1. 登录ZABBIX服务器，执行以下命令下载Trap接收脚本： 
      [root@appliance~]# yum install -y net-snmp-utils net-snmp-perl net-snmp    #安装Trap组件包
[root@appliance~]# sudo yum install wget    #安装wget命令行
[root@appliance~]# wget https://cdn.zabbix.com/zabbix/sources/stable/6.0/zabbix-6.0.31.tar.gz    #下载ZABBIX Sources文件，请选择与当前ZABBIX平台相符的版本
[root@appliance~]# sudo yum install tar    #安装tar命令行
[root@appliance~]# tar zxvf zabbix-6.0.31.tar.gz    #解压ZABBIX Sources文件
[root@appliance~]# cp /root/zabbix-6.0.31/misc/snmptrap/zabbix_trap_receiver.pl /usr/bin/zabbix_trap_receiver.pl    #复制Trap接收脚本到/usr/bin目录下
[root@appliance~]# chmod +x /usr/bin/zabbix_trap_receiver.pl    #为Trap接收脚本赋予权限
    2. 参考以下示例，编辑snmptrapd配置文件： 
      [root@appliance~]# vi /etc/snmp/snmptrapd.conf    #进入snmptrapd.conf文件编辑模式,添加以下配置
--------------------------------------------------------------------------------------------------------------
# Modify at XXXXXXXX
disableAuthorization yes
perl do "/usr/bin/zabbix_trap_receiver.pl"
    3. 参考以下示例，编辑ZABBIX Server配置文件： 
      [root@appliance~]# vi /etc/zabbix/zabbix_server.conf    #进入zabbix_server.conf文件编辑模式
-------------------------------------------------------------------------------------------------------------------
在配置文件中，设置以下两项：
StartSNMPTrapper=1    #启用SNMP Trap服务
SNMPTrapperFile=/tmp/zabbix_traps.tmp    #此处填写的路径必须和zabbix_trap_receiver.pl中的SNMPTrapperFile保持一致
    4. 将ZStack Cloud MIB文件存放在ZABBIX服务器/usr/share/snmp/mibs目录下，可使用以下命令直接下载： 
      [root@appliance~]# wget -P /usr/share/snmp/mibs http://172.26.51.205:5000/public/ZSTACK-CLOUD-MIB.mib
#其中，172.26.51.205:5000是本场景下ZStack Cloud UI访问地址，请根据实际情况填写
[root@appliance~]# vi /etc/snmp/snmp.conf    #创建snmp.conf文件，并添加以下配置：
-----------------------------------------------------------------------------------------------------------------------
mibs +ALL
    5. 执行以下命令，重启ZABBIX Server使配置生效： 
      [root@appliance~]# systemctl restart snmptrapd.service
[root@appliance~]# systemctl restart zabbix-server
  5. 登录ZStack Cloud创建报警器，创建SNMP Trap接收端通知对象。
    在ZStack Cloud主菜单，点击平台运维 > 云平台监控 > 通知对象，进入通知对象界面。在通知对象界面，点击创建通知对象，进入创建通知对象界面。
    可参考以下示例输入相应内容：
    • 名称：设置通知对象名称，本场景设置为SNMP Trap
    • 类型：选择SNMP Trap接收端
    • SNMP Trap接收端：选择已添加的SNMP Trap接收端
    点击发送测试消息，发送成功后即可添加通知对象。
    如图 20所示：
    图 20. 添加SNMP Trap接收端通知对象


  6. 创建报警器并绑定SNMP Trap接收端通知对象。
    本场景以创建资源报警器，在云主机CPU空闲率超过80%并持续30秒时发送报警为例进行介绍，实际使用中，请根据业务需求合理配置。
    在ZStack Cloud主菜单，点击平台运维 > 云平台监控 > 报警器 > 资源报警器，进入资源报警器界面。在资源报警器界面，点击创建资源报警器，进入创建资源报警器界面，创建如上资源报警器，通知对象选择创建好的SNMP Trap接收端通知对象。
    如图 21所示：
    图 21. 创建报警器并绑定SNMP Trap接收端通知对象


  7. 登录ZABBIX平台，对接ZStack Cloud。
    在ZABBIX主菜单，点击Configuration > Hosts，在Hosts界面，点击Create Host，进入New Host界面，将ZStack Cloud作为一个主机添加到ZABBIX。
    可参考以下信息输入相应内容：
    • Host Name：输入主机名称，本场景下设置为Cloud
    • Group：为主机选择分组
    • Interface：点击Add > SNMP，并设置以下参数：
      • IP address：输入ZStack Cloud管理节点IP
      • Connect to：选择Connect to IP
      • Port：输入在ZStack Cloud设置的SNMP Agent端口，本场景为1161
      • SNMP version：选择SNMP协议类型，需和ZStack Cloud上配置的一致，本场景选择SNMPv2
      • SNMP community：输入在ZStack Cloud上设置的团体字，本场景为v2c-test
      • 其他参数可按需设置
    如图 22所示：
    图 22. 在ZABBIX对接ZStack Cloud


    对接完成的ZStack Cloud将显示在ZABBIX Hosts列表中，等待几分钟，如Availability栏显示为绿色，则表示对接成功，ZABBIX可与ZStack Cloud通信。
    如图 23所示：
    图 23. 成功对接ZStack Cloud


  8. 添加SNMP Trap监控项
    在ZABBIX主菜单，点击Configuration > Hosts，选择刚刚创建好的Cloud主机，点击Items，进入Items界面。在Items界面，点击Create，弹出创建监控项界面。
    可参考以下示例输入响应内容：
    • Name：设置监控项名称，本场景设置为Cloud_SNMP_Trap
    • Type：选择SNMP trap
    • Key：选择snmp.fallback
    • Type of information：选择Log
    • Host interface：选择刚刚创建的Cloud主机的IP接口
    • History storage period：设置历史数据保留时间
    其他参数可按需设置。如图 24所示：
    图 24. 添加SNMP Trap监控项


  9. 查看报警消息。
    在ZABBIX主菜单，点击Monitoring > Latest data，在Latest Data界面，找到刚刚创建的SNMP Trap监控项，点击History，即可查看ZStack Cloud推送的报警消息。
    如图 25所示：
    图 25. 查看报警消息




后续操作

至此，用户已成功在ZABBIX平台接收ZStack Cloud报警消息。获取ZABBIX平台更多使用方法，可参考ZABBIX官方文档。
上一篇监控报警功能使用教程下一篇计费功能使用教程
SNMP管理使用教程 | 5.5.30 | ZStack Cloud · ZCF | ZStack 资源中心