1. [翻译] PySNMP教程 ¶

Note

地址：PySNMP

注：涉及到SNMP的专有名词一律不予以翻译, 并用粗体表示。

1.1. 快速入门 ¶

只要你在你的计算机上下载并安装了PySNMP库，你就可以解决非常基本的SNMP问题, 如通过Python命令行获取某个远程SNMP Agent的数据(你至少需要4.3.0以上版本，才可以执行后面的示例代码)。

1.1.1. 获取SNMP变量 ¶

复制和粘贴下列代码到Python命令提示符上，代码将会执行SNMP GET操作获取sysDescr.0对象，这是一个公开可用的SNMP Command Responder, 更多对象请参考demo.snmplabs.com

"""
SNMPv1
++++++

Send SNMP GET request using the following options:

  * with SNMPv1, community 'public'
  * over IPv4/UDP
  * to an Agent at demo.snmplabs.com:161
  * for two instances of SNMPv2-MIB::sysDescr.0 MIB object,

Functionally similar to:

| $ snmpget -v1 -c public demo.snmplabs.com SNMPv2-MIB::sysDescr.0

"""#
from pysnmp.hlapi import *

errorIndication, errorStatus, errorIndex, varBinds = next(
    getCmd(SnmpEngine(),
           CommunityData('public', mpModel=0),
           UdpTransportTarget(('demo.snmplabs.com', 161)),
           ContextData(),
           ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr', 0)))
)

if errorIndication:
    print(errorIndication)
elif errorStatus:
    print('%s at %s' % (errorStatus.prettyPrint(),
                        errorIndex and varBinds[int(errorIndex) - 1][0] or '?'))
else:
    for varBind in varBinds:
        print(' = '.join([x.prettyPrint() for x in varBind]))

如果一切执行正常，那么将会在你的终端打印：

...
SNMPv2-MIB::sysDescr."0" = SunOS zeus.snmplabs.com 4.1.3_U1 1 sun4m
>>>

1.1.2. 发送SNMP TRAP¶

想给demo.snmplabs.com中列出的宿主Notification Receiver发送TRAP消息，复制以下代码到你的交互式Python会话中。

"""
SNMPv1 TRAP with defaults
+++++++++++++++++++++++++

Send SNMPv1 TRAP through unified SNMPv3 message processing framework
using the following options:

* SNMPv1
* with community name 'public'
* over IPv4/UDP
* send TRAP notification
* with Generic Trap #1 (warmStart) and Specific Trap 0
* with default Uptime
* with default Agent Address
* with Enterprise OID 1.3.6.1.4.1.20408.4.1.1.2
* include managed object information '1.3.6.1.2.1.1.1.0' = 'my system'

Functionally similar to:

| $ snmptrap -v1 -c public demo.snmplabs.com 1.3.6.1.4.1.20408.4.1.1.2 0.0.0.0 1 0 0 1.3.6.1.2.1.1.1.0 s "my system"

"""#
from pysnmp.hlapi import *

errorIndication, errorStatus, errorIndex, varBinds = next(
    sendNotification(
        SnmpEngine(),
        CommunityData('public', mpModel=0),
        UdpTransportTarget(('demo.snmplabs.com', 162)),
        ContextData(),
        'trap',
        NotificationType(
            ObjectIdentity('1.3.6.1.6.3.1.1.5.2')
        ).addVarBinds(
            ('1.3.6.1.6.3.1.1.4.3.0', '1.3.6.1.4.1.20408.4.1.1.2'),
            ('1.3.6.1.2.1.1.1.0', OctetString('my system'))
        )
    )
)

if errorIndication:
    print(errorIndication)

许多ASN.1 MIB文件可以通过mibs.snmplabs.com进行下载，也可以配置PySNMP自动下载他们。

SNMPv2c对GETNEXT命令进行了重大优化——它的修订版本称作GETBULK，并能立刻对一系列next MIB对象进行收集和响应。额外的非中继和最大可重复参数可以用来影响MIB对象分批处理(Additional non-repeaters and max-repetitions parameters can be used to influence MIB objects batching.)。

PySNMP在协议层隐藏了GETBULK优化，bulkCmd()函数暴露了同样的生成器API，使getNext()使用更方便。

>>> from pysnmp.hlapi import *
>>>
>>> N, R = 0, 25
>>> g = bulkCmd(SnmpEngine(),
...             CommunityData('public'),
...             UdpTransportTarget(('demo.snmplabs.com', 161)),
...             ContextData(),
...             N, R,
...             ObjectType(ObjectIdentity('1.3.6')))
>>>
>>> next(g)
(None, 0, 0, [ObjectType(ObjectIdentity('1.3.6.1.2.1.1.1.0'), DisplayString('SunOS zeus.snmplabs.com'))])
>>> next(g)
(None, 0, 0, [ObjectType(ObjectIdentity('1.3.6.1.2.1.1.2.0'), ObjectIdentifier('1.3.6.1.4.1.20408'))])

Python生成器不仅可以产生数据，也可以给运行中的生成器对象发送数据。这个特性被高级API用来为一系列MIB对象重复相同的SNMP操作。

>>> from pysnmp.hlapi import *
>>>
>>> g = nextCmd(SnmpEngine(),
...             CommunityData('public'),
...             UdpTransportTarget(('demo.snmplabs.com', 161)),
...             ContextData(),
...             ObjectType(ObjectIdentity('IF-MIB', 'ifTable')))
>>>
>>> g.send([ObjectType(ObjectIdentity('IF-MIB', 'ifInOctets'))])
(None, 0, 0, [(ObjectType(ObjectIdentity('1.3.6.1.2.1.2.2.1.10.1'), Counter32(284817787))])

你可以通过把他们放在一个PDU中来操作很多不相干的MIB对象。应答PDU也会携带一系列MIB对象，他们的值和请求消息的排列顺序相同。

>>> from pysnmp.hlapi import *
>>>
>>> g = getCmd(SnmpEngine(),
...            CommunityData('public'),
...            UdpTransportTarget(('demo.snmplabs.com', 161)),
...            ContextData(),
...            ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr', 0)),
...            ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysUpTime', 0))
... )
>>> next(g)
(None, 0, 0, [ObjectType(ObjectIdentity('1.3.6.1.2.1.1.1.0'), DisplayString('SunOS zeus.snmplabs.com')), ObjectType(ObjectIdentity('1.3.6.1.2.1.1.3.0'), TimeTicks(44430646))])

部分SNMP配置管理依赖于SNMP SET命令。虽然在被管理实体端，它的实现被证明很苛刻(由于锁和事务行为)。所以厂商趋向于移除它，致使被管理实体是只读的。

PySNMP通过setCmd()函数支持统一的set操作。

>>> from pysnmp.hlapi import *
>>>
>>> g = setCmd(SnmpEngine(),
...            CommunityData('public'),
...            UdpTransportTarget(('demo.snmplabs.com', 161)),
...            ContextData(),
...            ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr', 0), 'Linux i386')
... )
>>> next(g)
(None, 0, 0, [ObjectType(ObjectIdentity('1.3.6.1.2.1.1.1.0'), DisplayString('Linux i386'))])

发送SNMP通知¶

被管理实体可以发送未经请求的消息给管理实体。这杯称为通知，通知可以减少轮训(轮询在大规模网络中可能会成为一个问题。)

SNMP通知是被枚举的(SNMP notifications are enumerated)，并且每一个都有确切的语义。这是通过一个特殊的，高级的SMI结构NOTIFICATION-TYPE完成的。和OBJECT-TYPE定义一个MIB对象类似，NOTIFICATION-TYPE也有一个唯一的OID，但是它的SNMP值引用的是其他MIB对象序列。这些MIB对象在通知被发送时用OBJECTS子句指定，他们的当前值被包含在通知消息中。

linkUp NOTIFICATION-TYPE
    OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
    STATUS  current
    DESCRIPTION
        "..."
::= { snmpTraps 4 }

为了在PySNMP中塑模NOTIFICATION-TYPE结构，我们用NotificationType类，这是一个包装对象。它被ObjectIdentity类标识，并引用一系列ObjectType类实例。

从行为角度看，NotificationType看起来像ObjectType类对象序列。

>>> from pysnmp.hlapi import *
>>>
>>> x = NotificationType(ObjectIdentity('IF-MIB', 'linkUp'))
>>> # ... calling MIB lookup ...
>>> >>> [ str(y) for x in n ]
['SNMPv2-MIB::snmpTrapOID.0 = 1.3.6.1.6.3.1.1.5.3', 'IF-MIB::ifIndex = ', 'IF-MIB::ifAdminStatus = ', 'IF-MIB::ifOperStatus = ']

用PySNMP发送SNMP通知和发送SNMP命令并没有太大不同。不同点在于如何构建PDU var-binds(The difference is in how PDU var-binds are built)。在SNMP中存在两种不同的通知：trap和inform。

对于trap，agent-to-manager通信是单向的，不会发送响应和确认。

>>> from pysnmp.hlapi import *
>>>
>>> g = sendNotification(SnmpEngine(),
...                      CommunityData('public'),
...                      UdpTransportTarget(('demo.snmplabs.com', 162)),
...                      ContextData(),
...                      'trap',
...                      NotificationType(ObjectIdentity('IF-MIB', 'linkUp'), instanceIndex=(123,))
... )
>>> next(g)
(None, 0, 0, [])

inform更像是一个命令，不同点在于PDU格式。inform用于manager-to-manager通信，也用于agent-to-manager通信。

>>> from pysnmp.hlapi import *
>>>
>>> g = sendNotification(SnmpEngine(),
...                      CommunityData('public'),
...                      UdpTransportTarget(('demo.snmplabs.com', 162)),
...                      ContextData(),
...                      'inform',
...                      NotificationType(ObjectIdentity('IF-MIB', 'linkUp'), instanceIndex=(123,))
... )
>>> next(g)

在后面的例子你会看到从IF-MIB::linkUp通知中自动扩展的MIB对象(ifIndex, ifAdminStatus, ifOperStatus)。为了通过索引处理SNMP表对象特定的行，可以用instanceIndex参数给NotificationType传递MIB对象的索引部分。

如你所见，扩展MIB对象的实际值为null。这是因为在我们的例子脚本没有访问这些MIB对象。我们可以提供这些缺失的信息：给NotificationType传递一个字典对象(该字典对象是MIB对象OID和当前值的映射)。

>>> from pysnmp.hlapi import *
>>>
>>> mib = {ObjectIdentifier('1.3.6.1.2.1.2.2.1.1.123'): 123,
...        ObjectIdentifier('1.3.6.1.2.1.2.2.1.7.123'): 'testing',
...        ObjectIdentifier('1.3.6.1.2.1.2.2.1.8.123'): 'up'}
>>>
>>> g = sendNotification(SnmpEngine(),
...                      CommunityData('public'),
...                      UdpTransportTarget(('demo.snmplabs.com', 162)),
...                      ContextData(),
...                      'inform',
...                      NotificationType(ObjectIdentity('IF-MIB', 'linkUp'), instanceIndex=(123,), objects=mib)
... )
>>> next(g)
(None, 0, 0, [ObjectType(ObjectIdentity('1.3.6.1.2.1.1.3.0'), TimeTicks(0)), ObjectType(ObjectIdentity('1.3.6.1.6.3.1.1.4.1.0'), ObjectIdentity('1.3.6.1.6.3.1.1.5.4')), ObjectType(ObjectName('1.3.6.1.2.1.2.2.1.1.123'), InterfaceIndex(123)), ObjectType(ObjectIdentity('1.3.6.1.2.1.2.2.1.7.123'), Integer(3)), ObjectType(ObjectIdentity('1.3.6.1.2.1.2.2.1.8.123'), Integer(1))])

大容量消息¶

当提到管理大规模网络时，顺序读取MIB对其会有时延。在某些方面，这些时延是不可忍受的。一种广为人知的方法是并行化查询——你可以在用多线程、多进程方式执行这些操作，或者围绕异步I/O模型构建你的应用程序。

和其他方式相比，异步模型最轻量级、最具扩展性。它的思想很简单：永远不要等待I/O——只要可能就去做其他的事情。这种方式的缺点是执行流不再是线性的，这将导致程序源码难以阅读分析。

PySNMP高级API采用三种异步I/O框架——asyncore，twisted和asyncio。异步API的更多信息，请参考PySNMP库参考手册和相关示例

1. [翻译] PySNMP教程 ¶

1.1. 快速入门 ¶

1.1.1. 获取SNMP变量 ¶

1.1.2. 发送SNMP TRAP¶

1.2. 参考手册 ¶

1.2.1. SNMP历史 ¶

SNMP是否还有用？¶

当前和今后的用途¶

1.2.2. SNMP设计 ¶

术语标准和实体¶

结构和组件¶

数据类型¶

对象标识符(OID)¶

对象集合¶

协议操作¶

核心应用¶

1.2.3. PySNMP架构 ¶

1.2.4. 常用操作 ¶

创建SNMP引擎¶

执行SNMP查询¶

选择SNMP协议和证书¶

设置传输和目标¶

处理SNMP上下文¶

指定MIB对象¶

读取标量值¶

SNMP表¶

SNMP命令操作¶

发送SNMP通知¶

大容量消息¶