Metadata-Version: 2.1
Name: datadog-snmp
Version: 11.0.0
Summary: The SNMP check
Project-URL: Source, https://github.com/DataDog/integrations-core
Author-email: Datadog <packages@datadoghq.com>
Keywords: datadog,datadog agent,datadog check,snmp
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: BSD License
Classifier: Private :: Do Not Upload
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Monitoring
Requires-Dist: datadog-checks-base>=37.9.0
Provides-Extra: deps
Requires-Dist: ply==3.11; extra == 'deps'
Requires-Dist: pyasn1==0.4.8; extra == 'deps'
Requires-Dist: pycryptodomex==3.23.0; extra == 'deps'
Requires-Dist: pysmi==1.2.1; extra == 'deps'
Requires-Dist: pysnmp-mibs==0.1.6; extra == 'deps'
Requires-Dist: pysnmp==5.1.0; extra == 'deps'
Description-Content-Type: text/markdown

# SNMP Check

## Overview

Simple Network Management Protocol (SNMP) is a standard for monitoring network-connected devices, such as routers, switches, servers, and firewalls. This check collects SNMP metrics from your network devices.

SNMP uses sysObjectIDs (System Object Identifiers) to uniquely identify devices, and OIDs (Object Identifiers) to uniquely identify managed objects. OIDs follow a hierarchical tree pattern: under the root is ISO, which is numbered 1. The next level is ORG and numbered 3 and so on, with each level being separated by a `.`.

A MIB (Management Information Base) acts as a translator between OIDs and human readable names, and organizes a subset of the hierarchy. Because of the way the tree is structured, most SNMP values start with the same set of objects:

* `1.3.6.1.1`: (MIB-II) A standard that holds system information like uptime, interfaces, and network stack.
* `1.3.6.1.4.1`: A standard that holds vendor specific information.

## Setup

To install and configure the SNMP integration, see the [Network Device Monitoring][1] documentation.

## Data Collected

### Metrics

See [metadata.csv][5] for a list of metrics provided by this integration.

### Service Checks

See [service_checks.json][6] for a list of service checks provided by this integration.

## Further Reading

Additional helpful documentation, links, and articles:

* [Monitor SNMP with Datadog][2]
* [Introduction to SNMP][3]

## Troubleshooting

Need help? Contact [Datadog support][4].

[1]: https://docs.datadoghq.com/network_monitoring/devices/setup
[2]: https://www.datadoghq.com/blog/monitor-snmp-with-datadog/
[3]: https://datadoghq.dev/integrations-core/tutorials/snmp/introduction/
[4]: https://docs.datadoghq.com/help/
[5]: https://github.com/DataDog/integrations-core/blob/master/snmp/metadata.csv
[6]: https://github.com/DataDog/integrations-core/blob/master/snmp/assets/service_checks.json
