SNMP Library for Python 7

• Return to PySNMP Homepage

PySNMP is a cross-platform, pure-Python SNMP engine implementation. It features fully-functional SNMP engine capable to act in Agent/Manager/Proxy roles, talking SNMP v1/v2c/v3 protocol versions over IPv4/IPv6 and other network transports.

Despite its name, SNMP is not really a simple protocol. For instance its third version introduces complex and open-ended security framework, multilingual capabilities, remote configuration and other features. PySNMP implementation closely follows intricate system details and features bringing most possible power and flexibility to its users.

Current PySNMP stable version is 7.0. It runs with Python 3.8+ and is recommended for new applications as well as for migration from older, now obsolete, PySNMP releases. All site documentation and examples are written for the 6.0 and later versions in mind. Older materials have been removed.

Besides the libraries, a set of pure-Python command line tools are shipped along with the system. Those tools mimic the interface and behavior of popular Net-SNMP snmpget/snmpset/snmpwalk utilities. They may be useful in a cross-platform situations as well as a testing and prototyping instrument for pysnmp users.

PySNMP software is free and open-source. Source code is hosted in the PySNMP Github repository. The library is being distributed under 2-clause BSD-style license.

PySNMP library development has been initially sponsored by a PSF grant.

Quick Start

You already know something about SNMP and have no courage to dive into this implementation? Try out quick start page!

• Quick Start

Documentation

You can find conceptual and API documentation in the following section.

• Documentation
  • SNMP History
  • SNMP Design
  • PySNMP Architecture
  • Common Operations
  • API References

Samples

We have a collection of sample scripts to help you get started with PySNMP.

• Samples
  • High-level SNMP
  • Low-level v3 architecture
  • Low-level v1 architecture
  • Low Level MIB Access
  • Using these examples
  • Related Resources

Troubleshooting

If you are having trouble with PySNMP, please check the following section.

• Troubleshooting
• Upgrade to 6.x/7.x Releases

Downloads

Best way is usually to install PySNMP using PySNMP PyPI package.

$ pip install pysnmp

If that does not work for you for some reason, you might need to read the following page.

• Downloads

We fanatically document all fixes, changes and new features in changelog.

• Changelog

License

This library is distributed under 2-clause BSD-style license.

• License

FAQ

We have a collection of frequently asked questions.

• FAQ
  • Getting peer address information
  • How to implement MIB at the Agent
  • Ignored SNMP packets
  • Listening on multiple network interfaces
  • Garbled SNMP values (apps)
  • Garbaged SNMP values (tools)
  • Dealing with the “OID not increasing” error
  • How to pass MIB to the Manager
  • My py2exe app can’t find MIBs
  • SNMP data constraints verification error
  • Related Resources

Contact

In case of questions or troubles using PySNMP, please open up a new GitHub issue or ask on Stack Overflow.

For other inquiries, please contact LeXtudio Inc..

More information about support options can be found in the following section.

• Support Options