Prometheus 监控网络设备最佳实践！

sudo yum update
sudo yum install net-snmp-utils

sudo apt update
sudo apt install snmp

snmpwalk -v 2c -c 社群密码 群晖IP

snmpwalk -v 2c -c 社群密码 群晖IP 1.3.6.1.4.1.6574.2.13

iso.3.6.1.4.1.6574.2.13 = No Such Object available on this agent at this OID

snmpwalk -v 2c -c 社群密码 群晖IP 1.3.6.1.4.1.6574.2

syno_mib:
  version:2
walk:
    -1.3.6.1.4.1.6574.2.1.1
metrics:
    -name:disk_health
      oid:1.3.6.1.4.1.6574.2.1.1.13
      type:gauge
      help:"Disk health status"
      indexes:
        -labelname:ifIndex
          type:gauge
      lookups:
        -labels:
            -ifIndex
          labelname:disk_name
          oid:1.3.6.1.4.1.6574.2.1.1.1
          type:DisplayString
    -name:disk_smart
      oid:1.3.6.1.4.1.6574.2.1.1.9
      type:gauge
      help:"Disk smart status"
      indexes:
        -labelname:ifIndex
          type:gauge
      lookups:
        -labels:
            -ifIndex
          labelname:disk_name
          oid:1.3.6.1.4.1.6574.2.1.1.1
          type:DisplayString
auth:
    community:社群

syno_mib: 定义了一个 SNMP 采集的配置项，名字为 syno_mib。 

version: 2 指定了 SNMP 的版本为 2，表示这个配置使用 SNMP v2 协议。   
walk: walk 是用来遍历指定的 OID 子树并抓取所有相关的 SNMP 数据。（这个get用不上）1.3.6.1.4.1.6574.2.1.1 这是需要遍历的 OID，代表这个 OID 及其子节点的数据将会被抓取。1.3.6.1.4.1.6574.2.1.1 通常与磁盘信息相关。

metrics: 定义了要采集的 SNMP 指标。

- name: disk_health 定义了一个名为 disk_health 的指标，用来表示磁盘的健康状态。

oid: 1.3.6.1.4.1.6574.2.1.1.13 指定了获取 disk_health 指标的 OID，1.3.6.1.4.1.6574.2.1.1.13 是这个健康状态的具体 OID。
   
type: gauge 指定了指标类型为 gauge，表示这个值是一个可以上下浮动的数值类型。
   
help: “Disk health status” 这是一段帮助信息，说明了这个指标的用途，表示它用于显示磁盘的健康状态。
   
indexes: 指定了该指标需要哪些索引值来标识。（这里开始往下的目的都是按 **1.3.6.1.4.1.6574.2.1.1.1** 即**硬盘索引号**划分返回的状态值）

- labelname: ifIndex 定义了一个标签名 ifIndex，通常是 SNMP 的接口索引，用于区分不同的磁盘。 type: gauge 说明这个索引值是一个 gauge 类型的值。

1lookups: 定义了一个映射关系，用于将索引值转换为可读的名称。

- labels: 定义了映射时需要使用的标签。
- ifIndex 指定使用 ifIndex 标签。

labelname: disk_name 定义了一个新的标签 disk_name，用于标识磁盘的名称。
    
oid: 1.3.6.1.4.1.6574.2.1.1.1 指定了用于获取磁盘名称的 OID，1.3.6.1.4.1.6574.2.1.1.1 用于查找磁盘的显示名称。
    
type: DisplayString 指定了该 OID 返回的值是一个 DisplayString 类型，即可显示的文本字符串。

# 拉取
docker pull prom/snmp-exporter:v0.26.0
# 在台能访问群晖 NAS 的设备上运行
docker run -d \
  -v /path/to/snmp.yml:/etc/snmp_exporter/snmp.yml \
  -p 9116:9116 \
  prom/snmp-exporter:v0.26.0

  - job_name:'snmp-syno-nas'
    scrape_interval:5m
    scrape_timeout:3m
    static_configs:
      -targets:
        -群晖NASIP1
        -群晖NASIP2
        -群晖NASIP3
        -群晖NASIP......
    metrics_path:/snmp
    params:
      module:[syno_mib]
    relabel_configs:
      -source_labels:[__address__]
        target_label:__param_target
      -source_labels:[__param_target]
        target_label:instance
      -target_label:__address__
        replacement:'IP:9116'

systemCPU-UsageEX OBJECT-TYPE
    SYNTAX Integer32
    MAX-ACCESS read-only
    STATUS     current
    DESCRIPTION
        "system CPU usage"
    ::= { systemInfoEx 1 }

systemCPU-UsageEX OBJECT-TYPE:定义了一个 SNMP 对象，名称为 systemCPU-UsageEX，表示系统 CPU 使用率的对象类型。

SYNTAX Integer32:这个属性定义了对象的类型，这里定义的 SYNTAX 是 Integer32，表示这个对象的值是 32 位整数。

MAX-ACCESS read-only:MAX-ACCESS 表示该对象的访问权限。read-only 说明这个对象只能被读取，不能修改。

STATUS current:STATUS 属性说明对象的状态。current 表示这是一个当前的有效对象。

DESCRIPTION “system CPU usage”:DESCRIPTION 是对该对象的简要描述，解释了这个对象表示的是系统 CPU 使用率。

::= { systemInfoEx 1 }:这是对象的 OID（对象标识符）。systemInfoEx 是一个父级节点，1 表示这是该父级节点下的第一个子对象。它标识了这个对象在整个 MIB 结构中的位置。

modules:
    qnap:
        walk:
            - raidCount
            - raidStatus

make docker-generate

# WARNING: This file was auto-generated using snmp_exporter generator, manual changes will be lost.
modules:
qnap:
    walk:
    -1.3.6.1.4.1.55062.1.10.5.1.4
    get:
    -1.3.6.1.4.1.55062.1.10.4.0
    metrics:
    -name:raidCount
      oid:1.3.6.1.4.1.55062.1.10.4
      type:gauge
      help:ThenumberofRAID.-1.3.6.1.4.1.55062.1.10.4
    -name:raidStatus
      oid:1.3.6.1.4.1.55062.1.10.5.1.4
      type:OctetString
      help:ThestatusofRAID-1.3.6.1.4.1.55062.1.10.5.1.4
      indexes:
      -labelname:raidIndex
        type:gauge

# 拉取
docker pull prom/snmp-exporter:v0.26.0
# 在台能访问QNAP NAS 的设备上运行
docker run -d \
  -v /path/to/snmp.yml:/etc/snmp_exporter/snmp.yml \
  -p 9116:9116 \
  prom/snmp-exporter:v0.26.0

  - job_name:'snmp-qnap-nas'
    scrape_interval:5m
    scrape_timeout:3m
    static_configs:
      -targets:
        -QNAPNASIP1
        -QNAPNASIP2
        -QNAPNASIP....
    metrics_path:/snmp
    params:
      module:[qnap]
    relabel_configs:
      -source_labels:[__address__]
        target_label:__param_target
      -source_labels:[__param_target]
        target_label:instance
      -target_label:__address__
        replacement:'IP:9116'

system-view
undo snmp-agent
snmp-agent
#重启snmp服务
display snmp-agent community
#查看之前的社群配置（加密了，所以显示乱码）
undo snmp-agent community <community-string>
#删除社群
snmp-agent community read <社群密码>

nc -zv -u <firewall-ip> 161
# 返回如下信息就是正常，否则请检查网络连接
# Connection to <firewall-ip> 161 port [udp/snmp] succeeded!
# UDP 端口不能使用telnet测试

sudo yum update
sudo yum install net-snmp-utils

sudo apt update
sudo apt install snmp

snmpwalk -v 2c -c 社群密码 华为防火墙IP