{"repo":"prometheus/snmp_exporter","free":true,"listed":false,"github":"https://github.com/prometheus/snmp_exporter","clone":"git clone https://github.com/prometheus/snmp_exporter.git","description":"SNMP Exporter for Prometheus","language":"Go","stars":2160,"topics":["prometheus","snmp","metrics","mib","monitoring","prometheus-exporter"],"license":"Apache-2.0","category":"analytics","readme_excerpt":"Prometheus SNMP Exporter [ ][quay] [ ][hub] This exporter is the recommended way to expose SNMP data in a format which Prometheus can ingest. To simply get started, it's recommended to use the if mib module with switches, access points, or routers using the public v2 auth module, which should be a read-only access community on the target device. Note, community strings in SNMP are not considered secrets, as they are sent unencrypted in SNMP v1 and v2c. For secure access, SNMP v3 is required. Concepts While SNMP uses a hierarchical data structure and Prometheus uses an n-dimensional matrix, the two systems map perfectly, and without the need to walk through data by hand. snmp exporter maps the data for you. Prometheus Prometheus is able to map SNMP index instances to labels. For example, the ifEntry specifies an INDEX of ifIndex . This becomes the ifIndex label in Prometheus. If an SNMP entry has multiple index values, each value is mapped to a separate Prometheus label. SNMP SNMP is structured in OID trees, described by MIBs. OID subtrees have the same order across different locations in the tree. The order under 1.3.6.1.2.1.2.2.1.1 ( ifIndex ) is the same as in 1.3.6.1.2.1.2.2.1.2 ( ifDescr ), 1.3.6.1.2.1.31.1.1.1.10 ( ifHCOutOctets ), etc. The numbers are OIDs, the names in parentheses are the names from a MIB, in this case IF-MIB. Mapping Given a device with an interface at number 2, a partial snmpwalk return looks like: snmp exporter combines all of this data into: Scalin","default_branch":null,"files":null,"tree":[],"storefront":"/r/prometheus","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/prometheus/snmp_exporter/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}