amkay/snmp_exporter

Prometheus SNMP Exporter镜像

镜像概述

本镜像提供Prometheus生态中的SNMP Exporter组件，用于从支持SNMP协议的网络设备（路由器、交换机、服务器等）采集监控指标，通过HTTP接口暴露给Prometheus进行数据抓取与分析，是构建网络设备监控体系的核心工具。

核心功能

• 支持SNMPv1、v2c、v3三种协议版本
• 灵活配置认证方式（社区字符串、用户名/密码、加密协议等）
• 自定义模块采集特定MIB对象
• 暴露标准HTTP接口（默认端口9116）供Prometheus抓取

使用场景

• 监控企业网络设备运行状态（接口流量、CPU/内存使用率等）
• 集成Prometheus实现跨设备统一监控与告警
• 适用于运维/DevOps场景的SNMP数据采集需求

配置说明

Docker部署示例

基础运行（默认配置）

bash
docker run -d -p 9116:9116 amkay/snmp_exporter

挂载自定义配置文件

bash
docker run -d -p 9116:9116 \
  -v /本地路径/snmp.yml:/etc/snmp_exporter/snmp.yml \
  amkay/snmp_exporter --config.file=/etc/snmp_exporter/snmp.yml

SNMP协议配置

SNMPv2c配置

yaml
default:
  version: 2
  auth:
    community: public  # 替换为设备实际社区字符串
  walk: [1.3.6.1.2.1.1]  # 系统信息OID
  metrics:
    - name: sysDescr
      oid: 1.3.6.1.2.1.1.1.0
      type: gauge

SNMPv3配置

yaml
default:
  version:3
  auth:
    username: monitor_user
    password: secure_pass
    auth_protocol: SHA
    priv_protocol: AES
    security_level: authPriv
    priv_password: priv_secure_pass
  walk: [1.3.6.1.2.1.1]
  metrics:
    - name: sysUpTime
      oid:1.3.6.1.2.1.1.3.0
      type: counter

Prometheus配置示例

在Prometheus的prometheus.yml中添加以下配置：

yaml
scrape_configs:
  - job_name: 'snmp'
    metrics_path: /snmp
    params: {module: [default]}
    static_configs:
      - targets: ['192.168.1.1']  # 目标设备IP
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: snmp-exporter:9116  # Exporter地址