UR/ERG3/ERG5系列 路由器 SNMP 配置与监控接入

本文以SNMP Explorer作为采集器，Prometheus

UR/ERG3/ERG5系列路由器 → SNMP Explorer → Prometheus

其中：

SNMP Exporter：把路由器提供的 SNMP 数据转换成 Prometheus 能读取的指标。它根据配置向路由器查询 OID，再通过 HTTP 暴露结果。

Prometheus：定时访问 SNMP Exporter，抓取并保存指标数据，并提供查询能力。

后续可以用其他看板工具读取Prometheus的数据绘制看板。

本文不会介绍SNMP Exporter和Prometheus的安装方法。

1.原理介绍

请求方向：Prometheus → SNMP Exporter → 路由器。

数据沿相反方向返回。独立 SNMP 浏览器是可选查询工具，不参与日常采集链路。

路由器 SNMP Agent

负责什么：响应 OID 查询，提供接口计数器、设备信息等。

本案例位置：192.168.6.1:161（UDP）

SNMP Exporter

负责什么：收到 /snmp 请求后查询路由器，把返回值映射为 Prometheus 指标；自身不保存长期历史。

本案例位置：192.168.6.101:9116（HTTP）

Prometheus

负责什么：周期性抓取 Exporter，保存带时间戳的指标，支持 PromQL 查询和规则计算。

本案例位置：192.168.6.101:9090（HTTP）

MIB / OID 参考资料

负责什么：描述对象名称、编号、类型、单位和索引，帮助选择与解释指标。

本案例位置：供查询工具或配置生成过程使用

本教程从已安装并可访问的服务开始。Exporter 的请求方式和配置字段按 SNMP Exporter官方说明核对。

2. 路由器：启用 SNMPv2c 只读访问

2.1 打开基本设置

登录路由器，进入 高级选项 → SNMP → 基本设置。以下采用原对话中已接通的 SNMPv2c 方案；如另行使用 SNMPv3，路由器用户和 Exporter 的认证、加密参数也必须一起配置。

SNMP / SNMP 版本：打开 SNMP，勾选 SNMPv2c。

联系信息 / 设备位置：原截图使用默认英文内容；按页面格式要求填写或保留。

本地引擎 ID：该页面是必填项。已有保存值时保留；首次配置按帮助要求填写 10–64 个十六进制字符，长度为偶数，并保持设备间唯一、长期稳定。它是设备标识，不是团体名。

SNMP 信任主机 IPv4 地址：本例为 192.168.6.101，即路由器看到的 Exporter 请求源地址。这里是单个 IPv4 字段，不填 /32。若容器使用独立地址，应按路由器实际看到的源地址配置。

NMS 主 / 辅监控接口：原截图主接口需要的WAN口、辅接口为空

SNMP Trap：本例保持关闭；Prometheus 通过轮询采集，不依赖 Trap。

首次配置后点击页面底部的应用 / 保存。相似 H3C Web 界面的引擎 ID 与信任主机字段规则可参考 H3C 官方手册 14.7 节；具体界面以该设备固件为准。

2.2 确认团体名和权限

切换到 团体名设置，确认采集使用的团体名具有只读权限。Exporter 中的 community 必须与这里完全一致，大小写也一致。

本例使用 public_v2 认证配置。若你修改过配置，应以实际文件为准。自定义团体名时要同步调整两端，且仅允许可信采集主机访问 UDP 161。v2c 团体名以明文传输；有加密要求时采用 SNMPv3。

3. SNMP Exporter：先确认路由器数据能读出

3.1 填写首页的三个参数

浏览器打开 http://192.168.6.101:9116/，按图填写：

Target

值：192.168.6.1

含义：被采集的路由器地址。

Auth

值：public_v2

含义：snmp.yml 中 auths 下已存在的配置名。

Module

值：if_mib

含义：采集接口指标的模块名。

点击 Submit，看到包含 ifOperStatus、ifHCInOctets 等名称的文本即可确认采集返回。这里只显示一次请求的指标文本，历史记录由 Prometheus 保存。

Auth 只填写配置名。不能把团体名、YAML 配置或随意起的 h3c_v2 填进去。只有 Exporter 已加载同名配置时，h3c_v2 才能使用；本案例已经验证的是 public_v2。

3.2 同时读取接口与运行时间

将 Module 改为 if_mib,system，或直接打开以下地址。这个组合已在当前服务上返回接口指标和 sysUpTime：

http://192.168.6.101:9116/snmp?target=192.168.6.1&auth=public_v2&module=if_mib,system

/snmp 用于查询目标设备；首页的 Metrics 链接指向 /metrics，主要是 Exporter 自身的运行指标。两者用途不同。官方端点说明

3.3 如需使用自定义团体名

在 Exporter 实际加载的配置文件中修改已有认证项，保留全部 modules。下面只展示认证部分，不能用它覆盖整份 snmp.yml；占位文字要替换为路由器端的只读团体名。

snmp.yml 的认证片段

auths:

  public_v2:

    version: 2

    community: "REPLACE_WITH_ROUTER_READ_ONLY_COMMUNITY"

按部署方式重启或重新加载 Exporter 后，再打开 3.2 的地址确认。若当前采集已正常且没有更改团体名的需求，直接继续下一节。

4. Prometheus：定时抓取并保存指标

4.1 编辑正在使用的 prometheus.yml

本案例配置文件保存路径为：

/var/apps/prometheus.prometheus/shares/prometheus/prometheus/prometheus.yml

请根据您的实际安装位置修改。

确认这是 Prometheus 当前使用或挂载的配置文件。在已有 scrape_configs: 列表中加入下列 job。若已经有 h3c-router，修改原 job；同一配置中不要重复写顶层 scrape_configs 或同名 job。

prometheus.yml · 本案例抓取任务（请务必注意缩进）

scrape_configs:

  - job_name: "h3c-router"

    scrape_interval: 15s

    scrape_timeout: 10s

    metrics_path: /snmp

    params:

      auth: [public_v2]

      module: [if_mib, system]

    static_configs:

      - targets:

          - "192.168.6.1"

    relabel_configs:

      - source_labels: [__address__]

        target_label: __param_target

      - source_labels: [__param_target]

        target_label: instance

      - target_label: __address__

        replacement: "192.168.6.101:9116"

targets 写路由器；replacement 写 Exporter。三条 relabel 依次把路由器地址送入 target 查询参数、保留为 instance 标签，再把真正的 HTTP 请求地址改为 Exporter。此处明确设置 15 秒间隔，便于按本案例复现。

4.2 检查配置并使其生效

在能读取该配置的 Prometheus 运行环境中，用附带的 promtool 检查。路径替换为实际路径；容器内使用容器内路径：

配置检查命令（路径需替换）

promtool check config /实际路径/prometheus.yml

检查成功后，重启 Prometheus；

HTTP 重载接口默认关闭。不要通过重载接口判断配置语法是否正确，应先执行 promtool。配置生效后等待一到两个抓取周期，本例约 15–30 秒。

4.3 查看目标状态

打开 Prometheus → Status → Target health，搜索 h3c-router。确认 Endpoint 是 Exporter 的 /snmp，参数同时有 if_mib、system，状态为 UP，instance 为路由器地址。

UP 表示该次抓取成功，仍需要在查询页确认你关心的指标确实存在。

5. 查询指标并完成验收

打开 Prometheus → Query，输入下列任意表达式，点击 Execute。首先使用 Table 查看数值；速率可切换 Graph 查看曲线。

抓取是否成功

PromQL：up{job="h3c-router",instance="192.168.6.1"}

结果含义：1 为成功，0 为失败；空结果要先检查 job 是否加载及查询时间。

接口运行状态

PromQL：ifOperStatus{job="h3c-router"}

结果含义：通常 1 为 up、2 为 down；存在其他状态值，按指标定义解释。

累计入站字节

PromQL：ifHCInOctets{job="h3c-router"}

结果含义：累计计数器，单位为字节。

各接口入站速率

PromQL：rate(ifHCInOctets{job="h3c-router"}[5m]) * 8

结果含义：bit/s；至少需要两次采样。除以 1000000 得到 Mbit/s。

各接口出站速率

PromQL：rate(ifHCOutOctets{job="h3c-router"}[5m]) * 8

结果含义：从路由器接口视角计算出站速率。

SNMP 管理子系统运行秒数

PromQL：sysUpTime{job="h3c-router"} / 100

结果含义：该案例的原始 sysUpTime 单位为百分之一秒。

完成后即可将看板工具接入。