Various SNMP versions#

SNMPv1#

Send SNMP GET request using the following options:

  • with SNMPv1, community ‘public’

  • over IPv4/UDP

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

  • for the 1.3.6.1.2.1.1.1.0 OID (e.g. 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.v1arch.asyncio import *


async def run():
    snmpDispatcher = SnmpDispatcher()

    iterator = await getCmd(
        snmpDispatcher,
        CommunityData("public", mpModel=0),
        await UdpTransportTarget.create(("demo.pysnmp.com", 161)),
        ("1.3.6.1.2.1.1.1.0", None),
    )

    errorIndication, errorStatus, errorIndex, varBinds = 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]))

    snmpDispatcher.transportDispatcher.closeDispatcher()


asyncio.run(run())

Download script.

Bulk walk MIB#

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

  • with SNMPv2c, community ‘public’

  • 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 -v2c -c public -Cn0 -Cr50
demo.pysnmp.com SNMPv2-MIB::system
import asyncio
from pysnmp.hlapi.v1arch.asyncio import *


async def run(varBinds):
    snmpDispatcher = SnmpDispatcher()

    while True:
        iterator = await bulkCmd(
            snmpDispatcher,
            CommunityData("public"),
            await UdpTransportTarget.create(("demo.pysnmp.com", 161)),
            0,
            50,
            *varBinds
        )

        errorIndication, errorStatus, errorIndex, varBindTable = iterator

        if errorIndication:
            print(errorIndication)
            break

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

        varBinds = varBindTable
        if isEndOfMib(varBinds):
            break

    snmpDispatcher.transportDispatcher.closeDispatcher()


asyncio.run(run([ObjectType(ObjectIdentity("SNMPv2-MIB", "sysDescr"))]))

Download script.

See also: library reference.