SNMP


许多Wi-Fi访问点和Wi-Fi路由器都支持简单的网络管理协议(SNMP)。这是一种用于监视/管理网络连接设备的标准化方法。SNMP使用一个类似树的层次结构,每个节点是对象。这些对象中有许多包含(实时)实例和指标列表,例如网络接口,磁盘和Wi-Fi注册。

目前,家庭助理中的以下设备类型支持:必威是什么

此设备跟踪器需要在路由器上启用SNMP。可能是您需要手动安装SNMP支持。

存在检测

以下OID示例从路由器中拉出当前的MAC地址表。这反映了网络上看到的所有最新设备。但是,由于设备直到止步之前才删除,因此对设备跟踪器集成页面比理想的。建议使用ping或者nmap反而。

品牌 设备/固件 OID
空气 AP230 1.3.6.1.4.1.26928.1.1.1.2.1.2.1.1
苹果 机场快车(第二代)7.6.9 1.3.6.1.2.1.3.1.1.2或者1.3.6.1.2.1.4.2.1.2
阿鲁巴 AOS 6.5.4.8上的IAP325 1.3.6.1.4.1.14823.3.3.3.1.2.4.1.1
BIPAC 7800DXL固件2.32E 1.3.6.1.2.1.17.7.1.2.2.1.1
DD-WRT 未知版本/型号 1.3.6.1.2.1.4.2.1.2
ipfire 2.25 1.3.6.1.2.1.4.2.1.2
Mikrotik 未知的Routeros版本/型号 1.3.6.1.4.1.14988.1.1.1.2.1.1
Mikrotik ROUTEROS 6.X在RB2011上 1.3.6.1.2.1.4.2.1.2
OpenWrt 混乱镇定15.05 1.3.6.1.2.1.4.2.1.2
opnsense 19.1 1.3.6.1.2.1.4.2.1.2
pfsense 2.2.4 1.3.6.1.2.1.4.2.1.2
骚动 划定指导9.13.3 1.3.6.1.4.1.25053.1.2.2.1.1.1.3.1.1.1.6
TP-Link Archer VR1600V 1.3.6.1.2.1.3.1.1.2.16.1
TP-Link Archer VR2600V 1.3.6.1.2.1.3.1.1.2.19.1
TP-Link Archer VR600 1.3.6.1.2.1.3.1.1.2
Ubiquiti Edgerouter Lite v1.9.0 1.3.6.1.2.1.4.2.1.2

要在安装中使用SNMP版本1或2C平台,请添加以下内容configuration.yaml文件:

#SNMP版本1或2C的示例Configuration.YAML条目device_tracker-平台SNMP主持人192.168.1.1社区上市碱类1.3.6.1.4.1.14988.1.1.1.2.1.1

如果要使用加密,则必须通过添加来启用SNMP版本3授权键priv_key变量并在路由器上启用SNMP版本3。目前,仅支持SHA1进行身份验证和AES进行加密。SNMPV3配置的示例:

#示例Configuration.yaml条目3device_tracker-平台SNMP主持人192.168.1.1社区用户名授权键Authpasspriv_keyPrivpass碱类1.3.6.1.4.1.14988.1.1.1.2.1.1

配置变量

主持人 细绳 必需的

路由器的IP地址,例如192.168.1.1。

社区 细绳 必需的

为设备设置的SNMP社区。大多数设备都设置为默认社区上市只有仅阅读许可(足够)。

碱类 细绳 必需的

可以找到无线客户端注册的OID前缀,通常是特定于供应商的。建议使用数值符号。要查找此基础OID,请检查供应商文档或检查MIB文件中的设备。

授权键 细绳 ((包括的

SNMPV3的身份验证密钥。多变的priv_key也必须设置。

priv_key 细绳 ((包括的

隐私密钥SNMPV3。多变的授权键也必须设置。

看到设备跟踪器集成页面有关说明,如何配置要跟踪的人。

传感器

SNMP传感器平台显示通过简单的网络管理协议(SNMP)。SNMP使用类似树的层次结构,每个节点都是对象,并且主要由面向网络的设备(例如路由器,调制解调器和打印机)支持。

要在安装中启用该传感器,请添加以下内容configuration.yaml文件:

#示例Configuration.yaml条目传感器-平台SNMP主持人192.168.1.32碱类1.3.6.1.4.1.2021.10.1.3.1

配置变量

主持人 细绳 ((选修的,默认:localhost

主机的IP地址,例如192.168.1.32

碱类 细绳 必需的

信息所在的OID。建议使用数值符号。

港口 细绳 ((选修的,默认:161

主机的SNMP端口。

社区 细绳 ((选修的,默认:公共

为SNMP V1和V2C设置的设备设置的SNMP社区。大多数设备都设置为默认社区上市只有仅阅读许可(足够)。

用户名 细绳 ((选修的

用于身份验证的用户名。

授权键 细绳 ((选修的,默认:无键

用于SNMP V3的身份验证密钥。

auth_protocol 细绳 ((选修的,默认:无

用于SNMP V3的身份验证协议。

priv_key 细绳 ((选修的,默认:无键

用于SNMP V3的隐私密钥。

priv_protocol 细绳 ((选修的,默认:无

用于SNMP V3的隐私协议。

版本 细绳 ((选修的,默认:1

SNMP协议的版本,1,,,,2C或者3。版本2C需要更高的时间来读取64位计数器的数据。

姓名 细绳 ((选修的

SNMP传感器的名称。

测量单位 细绳 ((选修的

定义传感器的测量单位(如果有)。

value_template 模板 ((选修的

定义a模板解析值。

Accept_Errors 细绳 ((选修的,默认:false

确定传感器是否应该启动并继续工作,即使SNMP主机无法触及或不响应。这允许传感器正确初始化,即使例如,您的打印机在开始家庭助理时就不在打开。必威是什么

默认值 细绳 ((选修的

确定传感器应采取的价值,如果Accept_Errors设置,主机无法到达或不响应。如果未设置,传感器将具有价值未知如果发生错误。

有效值auth_protocol

  • 没有任何
  • HMAC-MD5
  • HMAC-SHA
  • HMAC128-SHA224
  • HMAC192-SHA256
  • HMAC256-SHA384
  • HMAC384-SHA512

有效值priv_protocol

  • 没有任何
  • des
  • 3des-ede
  • AES-CFB-128
  • AES-CFB-192
  • AES-CFB-256

寻找OID

OID可能在不同的系统上有所不同,因为它们是供应商特定的。除了设备的手册,OID存储库如果您正在寻找OID,则是一个很好的起点。例如,以下OID用于Linux系统的负载。

  • 1分钟负载:1.3.6.1.4.1.2021.10.1.3.1
  • 5分钟负载:1.3.6.1.4.1.2021.10.1.3.2
  • 15分钟的负载:1.3.6.1.4.1.2021.10.1.3.3

SNMP可以使用大量工具。snmpwalk让您轻松检索OID的值。

$snmpwalk-os-C上市-v2C 192.168.1.32 1.3.6.1.4.1.2021.10.1.3.1 laload.1=字符串:0.19

例子

打印机正常运行时间

根据最常见的SNMP标准,设备的正常运行时间可在OID下访问1.3.6.1.2.1.1.3.0。使用称为格式表示的值时间表,以百分之一的单位为单位。

要创建一个在几分钟内显示打印机的正常运行时间的传感器,您可以使用此配置:

#示例Configuration.yaml条目传感器-平台SNMP姓名打印机正常运行时间”主持人192.168.2.21碱类1.3.6.1.2.1.1.3.0Accept_Errors真的测量单位分钟”value_template{{((价值|int)/6000)|int}}”

Accept_Errors即使在首次启动家庭助手时,即使打印机不打开,选项也将允许传感器工作:传感器只会显示一个必威是什么-而不是一分钟。

value_template选项将原始值转换为分钟。

转变

SNMP开关平台允许您控制支持SNMP的设备。

当前,仅支持接受整数值的SNMP OID。支持SNMP V1,V2C和V3。

在安装中使用SNMP开关:

#示例Configuration.yaml条目:转变-平台SNMP主持人192.168.0.2碱类1.3.6.1.4.4.1.19865.1.2.1.4.0

配置变量

碱类 细绳 必需的

为开关状态进行轮询的SNMP基础定型。

Command_oid 细绳 ((选修的

如果与碱类

主持人 细绳 ((选修的,默认:localhost

可以控制的IP/主机。

港口 细绳 ((选修的,默认:161

沟通的端口。

社区 细绳 ((选修的,默认:私人

用于身份验证的社区字符串(SNMP V1和V2C)。

用户名 细绳 ((选修的

用于身份验证的用户名。

授权键 细绳 ((选修的,默认:无键

用于SNMP V3的身份验证密钥。

auth_protocol 细绳 ((选修的,默认:无

用于SNMP V3的身份验证协议。

priv_key 细绳 ((选修的,默认:无键

用于SNMP V3的隐私密钥。

priv_protocol 细绳 ((选修的,默认:无

用于SNMP V3的隐私协议。

版本 细绳 ((选修的,默认:1

SNMP版本要使用 - 要么1,,,,2C或者3

payload_on 细绳 ((选修的,默认:1

什么回报值代表开关的状态。如果写作中使用相同的值来打开开关command_payload_on未设置。

payload_off 细绳 ((选修的,默认:0

什么回报值代表离开开关的状态。如果在写作中使用相同的值来关闭开关command_payload_off未设置。

command_payload_on 细绳 ((选修的

如果与payload_on

command_payload_off 细绳 ((选修的

如果与payload_off

VARTYPE 细绳 ((选修的,默认:无

SNMP vartypepayload_onpayload_off定义的命令RFC1902

您应该向设备的供应商核实,以找出正确的基础固定,以及什么值打开和关闭的值。

有效值auth_protocol

  • 没有任何
  • HMAC-MD5
  • HMAC-SHA
  • HMAC128-SHA224
  • HMAC192-SHA256
  • HMAC256-SHA384
  • HMAC384-SHA512

有效值priv_protocol

  • 没有任何
  • des
  • 3des-ede
  • AES-CFB-128
  • AES-CFB-192
  • AES-CFB-256

有效值VARTYPE

  • 反击32
  • 反击64
  • Gauge32
  • Integer32
  • 整数
  • IP地址
  • ObjectIdentifier
  • Octetstring
  • 不透明
  • 时间表
  • unsigned32

完整的示例:

转变-平台SNMP姓名SNMP V1开关主持人192.168.0.2社区私人的碱类1.3.6.1.4.4.1.19865.1.2.1.4.0payload_on1payload_off0-平台SNMP姓名SNMP V3开关主持人192.168.0.3版本3“用户名myusername”授权键Myauthkey”auth_protocolHMAC-SHA”priv_keymyprivkey”priv_protocolAES-CFB-128”碱类1.3.6.1.4.4.1.19865.1.2.1.4.0payload_on1payload_off0-平台SNMP姓名使用SNMP V3启用NetGear Switch端口2上的POE主持人192.168.0.4版本3“用户名myusername”授权键Myauthkey”auth_protocolHMAC-SHA”priv_keymyprivkey”priv_protocoldes”碱类1.3.6.1.4.1.4526.11.15.1.1.1.1.1.1.2payload_on15400payload_off3000VARTYPEGauge32