17 KiB
SNMP device monitoring with Netdata
Collects data from any SNMP device and uses the net-snmp module.
It supports:
- all SNMP versions: SNMPv1, SNMPv2c and SNMPv3
- any number of SNMP devices
- each SNMP device can be used to collect data for any number of charts
- each chart may have any number of dimensions
- each SNMP device may have a different update frequency
- each SNMP device will accept one or more batches to report values (you can set
max_request_sizeper SNMP server, to control the size of batches).
Requirements
nodejsminimum required version 4
Configuration
You will need to create the file /etc/netdata/node.d/snmp.conf with data like the following.
In this example:
- the SNMP device is
10.11.12.8. - the SNMP community is
public. - we will update the values every 10 seconds (
update_every: 10under the server10.11.12.8). - we define 2 charts
snmp_switch.bandwidth_port1andsnmp_switch.bandwidth_port2, each having 2 dimensions:inandout. Note that the charts and dimensions must not contain any white space or special characters, other than.and_.
{
"enable_autodetect": false,
"update_every": 5,
"max_request_size": 100,
"servers": [
{
"hostname": "10.11.12.8",
"community": "public",
"update_every": 10,
"max_request_size": 50,
"options": {
"timeout": 10000
},
"charts": {
"snmp_switch.bandwidth_port1": {
"title": "Switch Bandwidth for port 1",
"units": "kilobits/s",
"type": "area",
"priority": 1,
"family": "ports",
"dimensions": {
"in": {
"oid": "1.3.6.1.2.1.2.2.1.10.1",
"algorithm": "incremental",
"multiplier": 8,
"divisor": 1024,
"offset": 0
},
"out": {
"oid": "1.3.6.1.2.1.2.2.1.16.1",
"algorithm": "incremental",
"multiplier": -8,
"divisor": 1024,
"offset": 0
}
}
},
"snmp_switch.bandwidth_port2": {
"title": "Switch Bandwidth for port 2",
"units": "kilobits/s",
"type": "area",
"priority": 1,
"family": "ports",
"dimensions": {
"in": {
"oid": "1.3.6.1.2.1.2.2.1.10.2",
"algorithm": "incremental",
"multiplier": 8,
"divisor": 1024,
"offset": 0
},
"out": {
"oid": "1.3.6.1.2.1.2.2.1.16.2",
"algorithm": "incremental",
"multiplier": -8,
"divisor": 1024,
"offset": 0
}
}
}
}
}
]
}
update_every is the update frequency for each server, in seconds.
max_request_size limits the maximum number of OIDs that will be requested in a single call. The default is 50. Lower this number of you get TooBig errors in Netdata's error.log.
family sets the name of the submenu of the dashboard each chart will appear under.
multiplier and divisor are passed by the plugin to the Netdata daemon and are applied to the metric to convert it properly to units. For incremental counters with the exception of Counter64 type metrics, offset is added to the metric from within the SNMP plugin. This means that the value you will see in debug mode in the DEBUG: setting current chart to... SET line for a metric will not have been multiplied or divided, but it will have had the offset added to it.
Caution: Counter64 metrics do not support `offset` (issue #5028).
The SNMP plugin supports Counter64 metrics with the only limitation that the `offset` parameter should not be defined. Due to the way Javascript handles large numbers and the fact that the offset is applied to metrics inside the plugin, the offset will be ignored silently.If you need to define many charts using incremental OIDs, you can use something like this:
{
"enable_autodetect": false,
"update_every": 10,
"servers": [
{
"hostname": "10.11.12.8",
"community": "public",
"update_every": 10,
"options": {
"timeout": 20000
},
"charts": {
"snmp_switch.bandwidth_port": {
"title": "Switch Bandwidth for port ",
"units": "kilobits/s",
"type": "area",
"priority": 1,
"family": "ports",
"multiply_range": [
1,
24
],
"dimensions": {
"in": {
"oid": "1.3.6.1.2.1.2.2.1.10.",
"algorithm": "incremental",
"multiplier": 8,
"divisor": 1024,
"offset": 0
},
"out": {
"oid": "1.3.6.1.2.1.2.2.1.16.",
"algorithm": "incremental",
"multiplier": -8,
"divisor": 1024,
"offset": 0
}
}
}
}
}
]
}
This is like the previous, but the option multiply_range given, will multiply the current chart from 1 to 24 inclusive, producing 24 charts in total for the 24 ports of the switch 10.11.12.8.
Each of the 24 new charts will have its id (1-24) appended at:
- its chart unique id, i.e.
snmp_switch.bandwidth_port1tosnmp_switch.bandwidth_port24 - its
title, i.e.Switch Bandwidth for port 1toSwitch Bandwidth for port 24 - its
oid(for all dimensions), i.e. dimensioninwill be1.3.6.1.2.1.2.2.1.10.1to1.3.6.1.2.1.2.2.1.10.24 - its priority (which will be incremented for each chart so that the charts will appear on the dashboard in this order)
The options given for each server, are:
port- UDP port to send requests too. Defaults to161.retries- number of times to re-send a request. Defaults to1.sourceAddress- IP address from which SNMP requests should originate, there is no default for this option, the operating system will select an appropriate source address when the SNMP request is sent.sourcePort- UDP port from which SNMP requests should originate, defaults to an ephemeral port selected by the operation system.timeout- number of milliseconds to wait for a response before re-trying or failing. Defaults to5000.transport- specify the transport to use, can be eitherudp4orudp6. Defaults toudp4.version- either0(v1) or1(v2) or3(v3). Defaults to0.idBitsSize- either16or32. Defaults to32. Used to reduce the size of the generated id for compatibility with some older devices.
SNMPv3
To use SNMPv3:
- set
versionto 3 - use
userinstead ofcommunity
User syntax:
{
"user": {
"name": "userName",
"level": 3,
"authProtocol": "3",
"authKey": "authKey",
"privProtocol": "2",
"privKey": "privKey"
}
}
Security levels:
- 1 is
noAuthNoPriv - 2 is
authNoPriv - 3 is
authPriv
Authentication protocols:
- "1" is
none - "2" is
md5 - "3" is
sha
Privacy protocols:
- "1" is
none - "2" is
des
For additional details please see net-snmp module readme.
Retrieving names from snmp
You can append a value retrieved from SNMP to the title, by adding titleoid to the chart.
You can set a dimension name to a value retrieved from SNMP, by adding oidname to the dimension.
Both of the above will participate in multiply_range.
Testing the configuration
To test it, you can run:
/usr/libexec/netdata/plugins.d/node.d.plugin 1 snmp
The above will run it on your console and you will be able to see what Netdata sees, but also errors. You can get a very detailed output by appending debug to the command line.
If it works, restart Netdata to activate the snmp collector and refresh the dashboard (if your SNMP device responds with a delay, you may need to refresh the dashboard in a few seconds).
Data collection speed
Keep in mind that many SNMP switches and routers are very slow. They may not be able to report values per second. If you run node.d.plugin in debug mode, it will report the time it took for the SNMP device to respond. My switch, for example, needs 7-8 seconds to respond for the traffic on 24 ports (48 OIDs, in/out).
Also, if you use many SNMP clients on the same SNMP device at the same time, values may be skipped. This is a problem of the SNMP device, not this collector.
Finding OIDs
Use snmpwalk, like this:
snmpwalk -t 20 -v 1 -O fn -c public 10.11.12.8
-t 20is the timeout in seconds-v 1is the SNMP version-O fnwill display full OIDs in numeric format (you may want to run it also without this option to see human readable output of OIDs)-c publicis the SNMP community10.11.12.8is the SNMP device
Keep in mind that snmpwalk outputs the OIDs with a dot in front them. You should remove this dot when adding OIDs to the configuration file of this collector.
Example: Linksys SRW2024P
This is what I use for my Linksys SRW2024P. It creates:
- A chart for power consumption (it is a PoE switch)
- Two charts for packets received (total packets received and packets received with errors)
- One chart for packets output
- 24 charts, one for each port of the switch. It also appends the port names, as defined at the switch, to the chart titles.
This switch also reports various other metrics, like snmp, packets per port, etc. Unfortunately it does not report CPU utilization or backplane utilization.
This switch has a very slow SNMP processors. To respond, it needs about 8 seconds, so I have set the refresh frequency (update_every) to 15 seconds.
{
"enable_autodetect": false,
"update_every": 5,
"servers": [
{
"hostname": "10.11.12.8",
"community": "public",
"update_every": 15,
"options": {
"timeout": 20000,
"version": 1
},
"charts": {
"snmp_switch.power": {
"title": "Switch Power Supply",
"units": "watts",
"type": "line",
"priority": 10,
"family": "power",
"dimensions": {
"supply": {
"oid": ".1.3.6.1.2.1.105.1.3.1.1.2.1",
"algorithm": "absolute",
"multiplier": 1,
"divisor": 1,
"offset": 0
},
"used": {
"oid": ".1.3.6.1.2.1.105.1.3.1.1.4.1",
"algorithm": "absolute",
"multiplier": 1,
"divisor": 1,
"offset": 0
}
}
},
"snmp_switch.input": {
"title": "Switch Packets Input",
"units": "packets/s",
"type": "area",
"priority": 20,
"family": "IP",
"dimensions": {
"receives": {
"oid": ".1.3.6.1.2.1.4.3.0",
"algorithm": "incremental",
"multiplier": 1,
"divisor": 1,
"offset": 0
},
"discards": {
"oid": ".1.3.6.1.2.1.4.8.0",
"algorithm": "incremental",
"multiplier": 1,
"divisor": 1,
"offset": 0
}
}
},
"snmp_switch.input_errors": {
"title": "Switch Received Packets with Errors",
"units": "packets/s",
"type": "line",
"priority": 30,
"family": "IP",
"dimensions": {
"bad_header": {
"oid": ".1.3.6.1.2.1.4.4.0",
"algorithm": "incremental",
"multiplier": 1,
"divisor": 1,
"offset": 0
},
"bad_address": {
"oid": ".1.3.6.1.2.1.4.5.0",
"algorithm": "incremental",
"multiplier": 1,
"divisor": 1,
"offset": 0
},
"unknown_protocol": {
"oid": ".1.3.6.1.2.1.4.7.0",
"algorithm": "incremental",
"multiplier": 1,
"divisor": 1,
"offset": 0
}
}
},
"snmp_switch.output": {
"title": "Switch Output Packets",
"units": "packets/s",
"type": "line",
"priority": 40,
"family": "IP",
"dimensions": {
"requests": {
"oid": ".1.3.6.1.2.1.4.10.0",
"algorithm": "incremental",
"multiplier": 1,
"divisor": 1,
"offset": 0
},
"discards": {
"oid": ".1.3.6.1.2.1.4.11.0",
"algorithm": "incremental",
"multiplier": -1,
"divisor": 1,
"offset": 0
},
"no_route": {
"oid": ".1.3.6.1.2.1.4.12.0",
"algorithm": "incremental",
"multiplier": -1,
"divisor": 1,
"offset": 0
}
}
},
"snmp_switch.bandwidth_port": {
"title": "Switch Bandwidth for port ",
"titleoid": ".1.3.6.1.2.1.31.1.1.1.18.",
"units": "kilobits/s",
"type": "area",
"priority": 100,
"family": "ports",
"multiply_range": [
1,
24
],
"dimensions": {
"in": {
"oid": ".1.3.6.1.2.1.2.2.1.10.",
"algorithm": "incremental",
"multiplier": 8,
"divisor": 1024,
"offset": 0
},
"out": {
"oid": ".1.3.6.1.2.1.2.2.1.16.",
"algorithm": "incremental",
"multiplier": -8,
"divisor": 1024,
"offset": 0
}
}
}
}
}
]
}