SNMP 协议应用实战：RJ45 以太网温湿度变送器接入服务器监控平台

iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).<企业号>

1.3.6.1.4.1.48530
├── 1.1.1.0   温度值（Integer32，放大10倍，单位0.1℃）
├── 1.1.2.0   湿度值（Integer32，放大10倍，单位0.1%RH）
├── 1.1.3.0   露点温度（Integer32，放大10倍）
├── 1.1.4.0   传感器状态（INTEGER: 1=正常, 2=故障, 3=校准中）
├── 1.2.1.0   温度上限阈值（写OID）
├── 1.2.2.0   温度下限阈值（写OID）
├── 1.2.3.0   湿度上限阈值（写OID）
├── 1.2.4.0   湿度下限阈值（写OID）
├── 1.3.1.0   SNMP Trap 使能（1=开启, 0=关闭）
├── 1.3.2.0   Trap 目标IP（OCTET STRING, IPv4）
├── 1.3.3.0   Trap 目标端口（Integer32, 默认162）
└── 1.3.4.0   Trap 团体名（OCTET STRING）

□ SNMP 版本：v2c（默认）/ v3（合规要求时启用）
□ 读团体名：自定义，不用 public
□ 写团体名：禁用（纯监控场景）或受限源IP
□ Agent 端口：161（默认，可改）
□ 允许访问的 NMS 源IP/子网：限定为监控服务器
□ 系统信息：sysName（设备名）、sysLocation（机柜位置）、sysContact（责任人）
□ NTP 服务器：指向内网 NTP
□ Trap 目标：NMS IP + 端口162 + 团体名
□ Trap 触发条件：越限、传感器故障、通信中断
□ 采样周期：30s（默认）或按需调整
□ 死区：温度±0.5℃、湿度±3%RH（防止微小波动触发 Trap）

主机名称：Rack-A05-Temp-01
可见名称：A05机柜温湿度
群组：Server Room / Rack Environment
接口：SNMP，IP 10.20.30.41，端口 161
SNMP 版本：SNMPv2c
SNMP 团体名：{$SNMP_COMMUNITY}（宏）

步骤1：正则表达式 → 匹配 \d+，输出 \0
步骤2：自定义倍数 → 0.1

名称：A05机柜温度过高
表达式：last(/Rack-A05-Temp-01/env.temp)>28
严重性：Warning

名称：A05机柜温度严重超限
表达式：last(/Rack-A05-Temp-01/env.temp)>32
严重性：Disaster

名称：A05机柜湿度异常
表达式：last(/Rack-A05-Temp-01/env.humi)<30 or last(/Rack-A05-Temp-01/env.humi)>70
严重性：Warning

名称：传感器通信中断
表达式：nodata(/Rack-A05-Temp-01/env.temp,5m)=1
严重性：High

modules:
  rack_env:
    walk:
      - 1.3.6.1.2.1.1              # 系统信息
      - 1.3.6.1.4.1.48530.1.1      # 温湿度数据
    version: 2
    auth:
      community: rack_monitor
    lookups: []
    overrides:
      envTemp:
        ignore: false
        regex_extracts: {}
      envHumi:
        ignore: false
        regex_extracts: {}

# 准备 MIB 文件
mkdir -p mibs
cp RACK-ENV-MIB.txt mibs/

# generator.yml
modules:
  rack_env:
    walk:
      - sysName
      - sysLocation
      - envTemp
      - envHumi
      - envDewPoint
      - envSensorStatus
    version: 2
    auth:
      community: rack_monitor

# 生成
./generator generate -m mibs/ -g generator.yml

scrape_configs:
  - job_name: 'rack_environment'
    static_configs:
      - targets:
        - 10.20.30.41
        - 10.20.30.42
        - 10.20.30.43
    metrics_path: /snmp
    params:
      module: [rack_env]
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - replacement: 127.0.0.1:9116
        target_label: __address__

# 温度面板
snmp_envTemp{instance=~"10.20.30.*"} / 10

# 湿度面板
snmp_envHumi{instance=~"10.20.30.*"} / 10

# 告警规则
groups:
- name: rack_env_alerts
  rules:
  - alert: RackTemperatureHigh
    expr: snmp_envTemp / 10 > 28
    for: 2m
    labels:
      severity: warning
    annotations:
      summary: "机柜 {{ $labels.instance }} 温度偏高 ({{ $value }}℃)"

NMS 每60s轮询一次 → 最坏情况：事件发生59s后才被发现

Trap 目标IP：10.20.30.100（NMS）
Trap 端口：162
Trap 团体名：trap_community
触发条件：
  - 温度 > 28℃（上限）
  - 温度 < 10℃（下限）
  - 湿度 > 70%RH（上限）
  - 湿度 < 30%RH（下限）
  - 传感器故障
  - 设备重启（冷启动 Trap）

# /etc/snmp/snmptrapd.conf
authCommunity execute trap_community
format execute %a %B %y/%m/%d %H:%M:%S %v
traphandle default /opt/trap_handler/dispatch.sh

#!/bin/bash
# /opt/trap_handler/dispatch.sh
# 读取标准输入的 Trap 数据
INPUT=$(cat)

# 解析关键字段
SOURCE_IP=$(echo "$INPUT" | awk '{print $1}')
TRAP_OID=$(echo "$INPUT" | grep -oP '1\.3\.6\.1\.4\.1\.48530\.\d+\.\d+\.\d+')
VALUE=$(echo "$INPUT" | grep -oP '\d+$')

# 写入日志
logger -t "SNMP_TRAP" "Source=$SOURCE_IP OID=$TRAP_OID Value=$VALUE"

# 推送到 Zabbix（通过 zabbix_sender）
echo "$SOURCE_IP snmp.trap.received \"$INPUT\"" | \
  /usr/bin/zabbix_sender -z zabbix-server -i -

# 或直接调用告警 API
curl -X POST http://alert-gateway/api/v1/traps \
  -H "Content-Type: application/json" \
  -d "{\"source\":\"$SOURCE_IP\",\"oid\":\"$TRAP_OID\",\"value\":$VALUE,\"ts\":\"$(date -Iseconds)\"}"

# /etc/snmp/snmptrapd.conf
authCommunity execute trap_community
perl do "/usr/local/share/zabbix_trap_receiver.pl";

# 伪代码：Trap 去重器
class TrapDeduplicator:
    def __init__(self, cooldown=300):
        self.recent = {}  # (ip, oid) → last_seen_ts
        self.cooldown = cooldown

    def should_forward(self, ip, oid, value):
        key = (ip, oid)
        now = time.time()
        if key in self.recent:
            if now - self.recent[key] < self.cooldown:
                return False  # 冷却期内，丢弃
        self.recent[key] = now
        return True

10.20.30.41  → A01机柜
10.20.30.42  → A02机柜
10.20.30.43  → A03机柜
...
10.20.30.60  → A20机柜

ip,rack_id,location,asset_tag,snmp_community
10.20.30.41,A01,Row-A-Rack-01,ASSET-001,rack_ro_2024
10.20.30.42,A02,Row-A-Rack-02,ASSET-002,rack_ro_2024

#!/bin/bash
# batch_config.sh

COMMUNITY="rack_rw_temp"
MIB="RACK-ENV-MIB"

while IFS=, read -r ip rack location asset; do
    echo "Configuring $ip ($rack)..."

    # 设置系统信息
    snmpset -v2c -c $COMMUNITY $ip \
        SNMPv2-MIB::sysName.0 s "$rack-Temp" \
        SNMPv2-MIB::sysLocation.0 s "$location" \
        SNMPv2-MIB::sysContact.0 s "dc-ops@example.com"

    # 设置 Trap 目标
    snmpset -v2c -c $COMMUNITY $ip \
        RACK-ENV-MIB::trapTargetIP.0 a "10.20.30.100" \
        RACK-ENV-MIB::trapTargetPort.0 i 162 \
        RACK-ENV-MIB::trapCommunity.0 s "trap_community" \
        RACK-ENV-MIB::trapEnable.0 i 1

    # 设置阈值
    snmpset -v2c -c $COMMUNITY $ip \
        RACK-ENV-MIB::tempHighLimit.0 i 280 \
        RACK-ENV-MIB::tempLowLimit.0 i 100 \
        RACK-ENV-MIB::humiHighLimit.0 i 700 \
        RACK-ENV-MIB::humiLowLimit.0 i 300

    echo "Done: $ip"
done < rack_mapping.csv

import requests

ZABBIX_URL = "http://zabbix/api_jsonrpc.php"
AUTH_TOKEN = "..."  # 登录获取

def create_host(ip, rack_id, community):
    payload = {
        "jsonrpc": "2.0",
        "method": "host.create",
        "params": {
            "host": f"{rack_id}-Temp",
            "interfaces": [{
                "type": 2,  # SNMP
                "main": 1,
                "useip": 1,
                "ip": ip,
                "dns": "",
                "port": "161"
            }],
            "groups": [{"groupid": "12"}],  # 机柜环境组
            "templates": [{"templateid": "10234"}],  # 温湿度模板
            "macros": [
                {"macro": "{$SNMP_COMMUNITY}", "value": community}
            ]
        },
        "id": 1
    }
    requests.post(ZABBIX_URL, json=payload, headers={
        "Authorization": f"Bearer {AUTH_TOKEN}"
    })

$ ping 10.20.30.41
64 bytes from 10.20.30.41: time=1.2ms    ← 网络通

$ snmpwalk -v2c -c rack_ro_2024 10.20.30.41 1.3.6.1.2.1.1
Timeout: No Response from 10.20.30.41    ← SNMP 不通

# 1. 确认端口是否开放
nmap -sU -p 161 10.20.30.41
# UDP 扫描不可靠，用 snmpget 指定超时
snmpget -v2c -c rack_ro_2024 -t 5 -r 2 10.20.30.41 1.3.6.1.2.1.1.5.0

# 2. 抓包看设备是否响应
tcpdump -nn -i eth0 host 10.20.30.41 and udp port 161
# 有请求无响应 → 设备 SNMP Agent 未启动或团体名不匹配
# 有请求有响应但 snmpwalk 仍超时 → 响应慢，加大超时时间

# 3. 检查设备侧
# Web 登录确认 SNMP 已启用
# 确认团体名完全一致（注意空格、大小写）
# 确认源IP在允许列表中

$ snmpget -v2c -c rack_ro_2024 10.20.30.41 1.3.6.1.4.1.48530.1.1.1.0
INTEGER: 235    ← 手动能采

Zabbix 监控项状态：不支持（Unsupported）

# 1. 确认 snmptrapd 在监听
netstat -ulnp | grep 162
# 或
ss -ulnp | grep 162

# 2. 本地发送测试 Trap
snmptrap -v2c -c trap_community localhost:162 '' \
  1.3.6.1.4.1.48530.0.1 \
  1.3.6.1.4.1.48530.1.1.1.0 i 300

# 3. 远程发送测试（从变送器）
# 通过设备 Web 界面触发"测试 Trap"

# 4. 抓包确认 Trap 到达
tcpdump -nn -i eth0 udp port 162

# 5. 检查 snmptrapd 日志
tail -f /var/log/messages | grep snmptrapd

时间线：10:00 → 23.5℃ → 10:01 → 89.3℃ → 10:02 → 23.4℃

# 单次获取温度和湿度
snmpbulkget -v2c -c rack_ro_2024 10.20.30.41 \
  1.3.6.1.4.1.48530.1.1.1.0 \
  1.3.6.1.4.1.48530.1.1.2.0

NMS 并发数 = min(CPU核数 × 2, 设备响应能力)
超时 = 3-5s（局域网内 3s 足够）
重试 = 1-2 次（超过 2 次会放大设备负载）

Security Name: monitor_user
Security Level: authPriv
Auth Protocol: SHA-256
Auth Password: <强密码>
Priv Protocol: AES-256
Priv Password: <强密码>