#yyds干货盘点# Prometheus Exporter（六）SNMP Exporter

#yyds干货盘点# Prometheus Exporter（六）SNMP Exporter

简单网络管理协议（SNMP，Simple Network Management Protocol）构成了互联网工程工作小组（IETF，Internet Engineering Task Force）定义的Internet协议族的一部分。该协议能够支持网络管理系统，用以监测连接到网络上的设备是否有任何引起管理上关注的情况。它由一组网络管理的标准组成，包含一个应用层协议（application layer protocol）、数据库模式（database schema），和一组资料对象。

在一台 Linux 主机上，我们可以使用 snmpwalk 命令来访问设备通过 SNMP 协议暴露的数据，比如最简单的查看所有信息的命令如下：

snmpwalk -v 2c -c xxxxxxxx 172.16.1.1

参数解释：

-v 2c : 指定 SNMP 协议的版本，当前指定为 2c -c xxxx : SNMP 的 Community 值 172.16.1.1 : 硬件的 IP地址

简单查看以后，我们需要长期监控，这个时候就要借助 SNMP Exporter 这个工具了。

SNMP Exporter 是 Prometheus 开源的一个支持 SNMP 协议的采集器，GitHub 地址 ： docker 部署或者二进制文件来进行部署

下载 docker image 使用如下命令，使用中请切换对应的版本。

docker pull prom/snmp-exporter:v0.20.0

如果使用二进制文件部署 ，下载地址如下：

SNMP Exporter 的使用来说， 配置文件比较重要，配置文件中根据硬件的 MIB 文件生成了 OID 的映射关系。以 Cisco 交换机为例，在官方 GitHub 上下载最新的 snmp.yml 文件，由于 Cisco 交换机使用的是 if_mib 模块，在 if_mib 下新增 auth ，用来在请求交换机的时候做验证使用，这个值是配置在交换机上的。

关于采集的监控项是在 walk 字段下，如果要新增监控项，写在 walk 项下。我新增了交换机的 CPU 和内存信息。

...... if_mib: auth: community: xxxx walk: - 1.3.6.1.2.1.2 - 1.3.6.1.2.1.31.1.1 - 1.3.6.1.4.1.9.2.1 # 交换机 CPU 相关信息 - 1.3.6.1.4.1.9.9.48 # 交换机内存相关信息 get: - 1.3.6.1.2.1.1.3.0 metrics: - name: busyPer oid: 1.3.6.1.4.1.9.2.1.56.0 type: gauge help: CPU utilization - name: avgBusy1 oid: 1.3.6.1.4.1.9.2.1.57.0 type: gauge help: CPU utilization in the past 1 minute - name: avgBusy2 oid: 1.3.6.1.4.1.9.2.1.58.0 type: gauge help: CPU utilization in the past 5 minute - name: MemoryPoolFree oid: 1.3.6.1.4.1.9.9.48.1.1.1.6.1 type: gauge help: ciscoMemoryPoolFree - name: MemoryPoolUsed oid: 1.3.6.1.4.1.9.9.48.1.1.1.5.1 type: gauge help: ciscoMemoryPoolUsed ......

在 Linux 系统中使用 Docker 来运行 SNMP Exporter 可以使用如下脚本

#!/bin/bash docker run -d --name snmp-exporter --restart=always -m 1g \ --volume /erdong/snmp-exporter/conf:/config \ --network host prom/snmp-exporter:v0.20.0 \ --web.listen-address :9107 \ --config.file=/config/snmp.yml

在 Linux 系统部署二进制文件，使用系统的 Systemd 来控制服务启停，系统服务文件可以这么写， 该脚本源自官方提供的脚本，相比于官方脚本增加了SNMP Exporter 运行端口的指定。文件 snmp_exporter.service 的内容如下：

[Unit] Description=SNMP Exporter After=network-online.target # This assumes you are running snmp_exporter under the user "prometheus" [Service] User=prometheus Restart=on-failure ExecStart=/usr/local/prometheus/snmp_exporter/snmp_exporter --config.file=/usr/local/prometheus/snmp_exporter/snmp.yml --web.listen-address=:9116 [Install] WantedBy=multi-user.target

起动好以后，我们可以访问 来查看启动的 SNMP Exporter ，页面上会显示 Target、Module、Submit、Config 这几个选项和按钮。

或者使用 curl 命令来验证，命令格式如下：

curl Prometheus 进行采集了。

Prometheus 配置

- job_name: NET-SW static_configs: - targets: - 192.168.2.2 # 思科交换机的 IP 地址 metrics_path: /snmp params: module: - if_mib # 如果是其他设备，请更换其他模块。 community: - xxxxxx # 指定 community，当 snmp_exporter snmp.yml 配置文件没有指定 community，此处定义的 community 生效。 relabel_configs: - source_labels: [__address__] target_label: __param_target - source_labels: [__param_target] target_label: instance - target_label: __address__ replacement: 192.168.1.2:9116 # SNMP Exporter 的地址和端口

配置好 Prometheus 以后启动 Prometheus 服务 ，就可以查到 Cisco 交换机的监控信息了。

接下来就 Prometheus 配置告警规则，Grafana 进行画图了。这些操作和其他组件并无区别，就不再赘述。

手动生成 snmp.yml 配置文件

上边在配置 SNMP Exporter 的配置文件的时候，使用了官方提供的默认的 snmp.yml ，有些设备官方的配置里并没有支持，这个时候就需要通过 MIB 文件来自己生成了，接下来我们看看这个配置文件怎么生成。

官方当前的 snmp.yml 支持 如下这些模块[2021.04.28]

apcups ： 一般用于 UPS 监控 arista_sw cisco_wlc ： 一般用于 ap 监控 ddwrt ： 一般用于软路由 if_mib ： 一般用于网络设备。该MIB描述了网络接口子层的通用表项。是MIB-II中ifTable的升级版本，也是对RFC1573扩展定义的具体说明。IF-MIB包含了一组与网络设备的通用接口相关的管理对象。这些管理对象适用于所有的网络接口，与接口上使用的通信介质合协议的类型无关。IF-MIB也定义了用于特殊介质和低层协议栈（子网层或更低层）的管理对象。 infrapower_pdu keepalived kemp_loadmaster liebert_pdu mikrotik nec_ix paloalto_fw printer_mib raritan servertech_sentry3 servertech_sentry4 synology ubiquiti_airfiber ubiquiti_airmax ubiquiti_unifi wienner_mpod

多机器不同模块如何采集

- job_name: snmp scrape_interval: 30s # 覆盖全局默认值 scrape_timeout: 5s # 覆盖全局默认值 file_sd_configs: - files: - /etc/prometheus/file_sd/snmp_device.yml # 指定 snmp 服务发现配置文件路径 metrics_path: /snmp params: module: - if_mib # 指定默认采集 MIB 模块的名称 community: - xxxxx 指定 community，当 snmp_exporter snmp.yml 配置文件没有指定 community，此处定义的 community 生效。 缺省值一般是 public 。 relabel_configs: - source_labels: - __address__ target_label: __param_target - source_labels: - __param_target target_label: instance - replacement: snmp_exporter:9116 target_label: __address__ - source_labels: # 从目标中获取MIB模块名称 - mib target_label: __param_module

snmp_device.yml 的内容参照如下格式即可。我在下面的示例中添加了architecture与model等变量，这些变量prometheus获取目标信息是，会作为目标的标签与目标绑定。

[ { "labels": { "mib": "if_mib", "brand": "Huawei", "hostname": "BJ-LG-HW5328", "model": "S5328C-EI" }, "targets": [ "192.168.100.1" ] }, { "labels": { "mib": "if_mib", "brand": "Huawei", "hostname": "SH-GQ-HW9306CSS", "model": "Quidway S9306" }, "targets": [ "192.168.100.2" ] }, { "labels": { "mib": "if_mib", "brand": "Huawei", "hostname": "BJ-LG-HW9306CSS", "model": "Quidway S9306" }, "targets": [ "192.168.100.3" ] }, { "labels": { "mib": "if_mib", "brand": "Huawei", "hostname": "GZ-RMZ-HW9306CSS", "model": "Quidway S9306" }, "targets": [ "192.168.100.4" ] } ]

ifOutOctets 和 ifInOctets 的指标说明，这是一个历史GitHub 里面找。这个里面有很多基础的MIB

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。