如何在LibreNMS中通过SNMP获取自定义OID数值？

问题背景 #

已通过snmpd的extend指令配置自定义OID，脚本可通过snmpwalk正常获取数值，但LibreNMS添加自定义OID后无法显示数据。

当前配置详情 #

1. snmpd.conf配置

extend  .1.3.6.1.2.1.25.1.7.1 temp_hi_in  /bin/sh /home/test/test.sh

2. 采集脚本内容

#!/bin/bash
SENSOR=$1
SLAVE="/sys/bus/w1/devices/28-666a741f64ff/w1_slave"
OUTPUT=$(/bin/cat $SLAVE | /usr/bin/awk -F 't=' ' { printf $2 } ')
echo .1.3.6.1.2.1.25.1.7.1
echo guage
echo $OUTPUT

3. 测试结果
   使用SNMPv3命令可正常获取数值28562：

snmpwalk -v3  -l auth -u {user} -a MD5 -A {MD5} localhost .1.3.6.1.2.1.25.1.7.1

但在LibreNMS中尝试添加.1.3.6.1.2.1.25.1.7.1、.1.3.6.1.2.1.25.1.7.1.4.1.2.10.116.101.109.112.95.104.105.95.105.110.3等OID后，均无法显示数值。

解决方案 #

1. 修正脚本数据类型拼写错误 #

脚本中guage是拼写错误，SNMP数据类型需严格匹配为gauge，错误的类型名会导致LibreNMS无法解析数据：

# 将原行
echo guage
# 修改为
echo gauge

2. 确认正确的数值OID路径 #

使用extend指令时，实际数值并非存储在你指定的.1.3.6.1.2.1.25.1.7.1下，而是位于NET-SNMP-EXTEND-MIB::nsExtendOutputFull分支。执行以下命令获取准确OID：

snmpwalk -v3 -l auth -u {user} -a MD5 -A {MD5} localhost NET-SNMP-EXTEND-MIB::nsExtendOutputFull

返回的目标OID格式应为：.1.3.6.1.4.1.8072.1.3.2.3.1.1.10.116.101.109.112.95.104.105.95.105.110（其中10是temp_hi_in的字符长度，后续数字为字符串的ASCII码）

3. LibreNMS添加自定义OID的正确步骤 #

• 进入设备详情页，点击Settings -> Custom OIDs
• 新增自定义OID：
  • Description：自定义名称（如"高温输入传感器"）
  • OID：填写上述命令获取的完整数值OID
  • Type：选择Gauge32（对应脚本中的gauge类型）
  • Units：根据数值填写（如0.001°C，对应28562即28.562℃）
• 保存后等待LibreNMS完成采集周期，即可查看数值。

4. 验证权限配置 #

确保snmpd进程有读取传感器文件和执行脚本的权限：

# 测试脚本执行权限
su -s /bin/bash snmp -c "/home/test/test.sh"
# 调整权限（若测试报错）
chmod +x /home/test/test.sh
chown snmp:snmp /home/test/test.sh
chmod o+r /sys/bus/w1/devices/28-666a741f64ff/w1_slave

内容的提问来源于stack exchange，提问作者omega1