forked from python-diamond/Diamond
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
40 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,40 @@ | ||
SNMPInterfaceCollector | ||
===== | ||
|
||
The SNMPInterfaceCollector is designed for collecting interface data from remote SNMP-enabled devices such as routers and switches. | ||
|
||
Installation | ||
===== | ||
|
||
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. | ||
|
||
Configuration | ||
===== | ||
|
||
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. |
File renamed without changes.