-
Notifications
You must be signed in to change notification settings - Fork 384
collectors SNMPInterfaceCollector
The SNMPInterfaceCollector is designed for collecting interface data from remote SNMP-enabled devices such as routers and switches using SNMP IF_MIB
The snmpinterfacecollector.py module should be installed into your Diamond installation collectors directory. This directory is defined in diamond.cfg under the collectors_path directive. This defaults to /usr/lib/diamond/collectors/ on Ubuntu.
The SNMPInterfaceCollector.cfg file should be installed into your diamond installation config directory. This directory is defined in diamond.cfg under the collectors_config_path directive. This defaults to /etc/diamond/ on Ubuntu.
Once the collector is installed and configured, you can wait for diamond to pick up the new collector automatically, or simply restart diamond.
Below is an example configuration for the SNMPInterfaceCollector. The collector can collect data any number of devices by adding configuration sections under the devices header. By default the collector will collect every 60 seconds. This might be a bit excessive and put unnecessary load on the devices being polled. You may wish to change this to every 300 seconds. However you need modify your graphite data retentions to handle this properly.
# Options for SNMPInterfaceCollector
path = interface
interval = 60
[devices]
[[router1]]
host = router1.example.com
port = 161
community = public
[[router2]]
host = router1.example.com
port = 161
community = public
Note: If you modify the SNMPInterfaceCollector configuration, you will need to restart diamond.
- pysmnp
- Generic Options
- retries: Number of times to retry before bailing
- enabled: Enable collecting these metrics
- timeout: Number of seconds before timing out the snmp connection
- byte_unit: Default numeric output(s)
All keys are prefixed with nodes.hostname by default