Various SNMP versions#

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 an instance of SNMPv2-MIB::sysDescr.0 MIB object

  • Based on asyncio I/O framework

Functionally similar to:

$ snmpget -v1 -c public demo.pysnmp.com SNMPv2-MIB::sysDescr.0
import asyncio
from pysnmp.hlapi.v3arch.asyncio import *


async def run():
    snmpEngine = SnmpEngine()

    iterator = getCmd(
        snmpEngine,
        CommunityData("public", mpModel=0),
        await UdpTransportTarget.create(("demo.pysnmp.com", 161)),
        ContextData(),
        ObjectType(ObjectIdentity("SNMPv2-MIB", "sysDescr", 0)),
    )

    errorIndication, errorStatus, errorIndex, varBinds = await iterator

    if errorIndication:
        print(errorIndication)

    elif errorStatus:
        print(
            "{} at {}".format(
                errorStatus.prettyPrint(),
                errorIndex and varBinds[int(errorIndex) - 1][0] or "?",
            )
        )
    else:
        for varBind in varBinds:
            print(" = ".join([x.prettyPrint() for x in varBind]))

    snmpEngine.closeDispatcher()


asyncio.run(run())

Download script.

Bulk walk MIB#

Send a series of SNMP GETBULK requests using the following options:

  • with SNMPv3, user ‘usr-none-none’, no authentication, no privacy

  • over IPv4/UDP

  • to an Agent at demo.pysnmp.com:161

  • for all OIDs past SNMPv2-MIB::system

  • run till end-of-mib condition is reported by Agent

  • based on asyncio I/O framework

Functionally similar to:

$ snmpbulkwalk -v3 -lnoAuthNoPriv -u usr-none-none -Cn0 -Cr50
demo.pysnmp.com SNMPv2-MIB::system
import asyncio
from pysnmp.hlapi.v3arch.asyncio import *


async def run(varBinds):
    snmpEngine = SnmpEngine()
    while True:
        errorIndication, errorStatus, errorIndex, varBindTable = await bulkCmd(
            snmpEngine,
            UsmUserData("usr-none-none"),
            await UdpTransportTarget.create(("demo.pysnmp.com", 161)),
            ContextData(),
            0,
            50,
            *varBinds,
        )

        if errorIndication:
            print(errorIndication)
            break
        elif errorStatus:
            print(
                f"{errorStatus.prettyPrint()} at {varBinds[int(errorIndex) - 1][0] if errorIndex else '?'}"
            )
        else:
            for varBind in varBindTable:
                print(" = ".join([x.prettyPrint() for x in varBind]))

        varBinds = varBindTable
        if isEndOfMib(varBinds):
            break
    return


asyncio.run(
    run([ObjectType(ObjectIdentity("TCP-MIB")), ObjectType(ObjectIdentity("IP-MIB"))])
)

Download script.

See also: library reference.