mellanox/ufm-plugin-gnmi-nvos-events

UFM GNMI NVOS Events插件镜像文档

镜像概述

mellanox/ufm-plugin-gnmi-nvos-events是一款UFM（Unified Fabric Manager）插件镜像，主要功能是监听网络中所有NVOS管理交换机发送的GNMI陷阱（traps），并将这些陷阱解析为事件后重定向到UFM系统，实现网络事件的集中收集与监控。

核心功能与特性

• GNMI陷阱监听：实时接收来自NVOS管理交换机的GNMI陷阱数据
• 事件解析与转发：将接收到的GNMI陷阱解析为标准事件格式，并发送至UFM系统
• 集中事件管理：通过UFM平台统一展示和管理网络设备事件

使用场景

适用于采用UFM管理NVOS交换机的网络环境，需要对交换机事件进行集中监控、告警和管理的场景，例如数据中心网络运维、企业级网络监控等。

部署方法

通过UFM WEB UI部署

1. 拉取插件容器：

   bash
   docker pull mellanox/ufm-plugin-gnmi-nvos-events
   

2. 登录UFM WEB UI，导航至 Settings > Plugin Management
3. 在插件管理页面添加已拉取的插件

通过CLI部署

在UFM Appliance上部署

1. 使用admin账户登录设备
2. 进入特权模式：

   bash
   enable
   

3. 进入配置模式：

   bash
   config terminal
   

4. 确认UFM服务状态：

   bash
   show ufm status
   

   • 若UFM未运行，启动UFM：

     bash
     ufm start
     

5. 确认GNMI NVOS Events插件当前状态（需确保其处于禁用状态）：

   bash
   show ufm plugin
   

6. 拉取插件容器：

   bash
   docker pull mellanox/ufm-plugin-gnmi-nvos-events
   

   • 若为HA（高可用）环境，需在备用节点也执行此步骤
7. （仅UFM Enterprise Appliance，如gen3）开放默认SNMP端口：

   bash
   # 若需要，先进入shell环境
   _shell
   ufw allow 162/udp
   

8. 启用插件：

   bash
   ufm plugin gnmi_events add
   

9. 验证插件状态：

   bash
   ufm plugin show
   

在UFM（SA或HA模式）上部署

1. 安装最新版本的UFM
2. 启动UFM服务：

   bash
   systemctl start ufm-infra
   

3. 拉取插件容器：

   bash
   docker pull mellanox/ufm-plugin-gnmi-nvos-events
   

   • 若为HA环境，需在备用节点也执行此步骤
4. 启用插件：

   bash
   /opt/ufm/scripts/manage_ufm_plugins.sh add -p gnmi_events
   

5. 验证插件运行状态：

   bash
   docker ps
   

日志位置

插件日志文件gnmi_nvos_events.log位于主机的/opt/ufm/files/log/plugins/gnmi-nvos-events目录下。

测试方法

插件启动后，所有在fabric中具有有效IP和SSH凭证（全局或本地）的管理交换机将以"变更时"模式向插件发送系统事件。插件解析事件后，以通用外部事件形式发送至UFM。

测试流程示例

1. 启动UFM服务
2. 加载插件
3. 在UFM的 Managed Elements > Devices 标签页确认交换机IP有效，或通过 Device Access 标签页手动设置
4. 通过 Settings > Device Access 标签页配置全局凭证
5. 登录交换机，执行端口重置操作（例如：nv action reset platform transceiver sw1p1）
6. 在UFM的 Events & Alarms 标签页检查是否收到事件

注意事项

• 仅支持最新版本的gnmi-server，已在4.13.0-3000版本上测试通过