SNMP Source
Provided by: "Apache Software Foundation"
Support Level for this Kamelet is: "Preview"
Reads values, such as uptime or interface counters, from a network device over SNMP at a regular interval, or receives the SNMP traps that devices send, one message per reading or trap.
Use it to monitor routers, switches, printers or servers that speak SNMP, for example to store their counters over time, or to forward their alarms (traps) to a ticketing or chat system.
Output: the body is XML text with one entry per value, each with its oid (the identifier of the value, such as 1.3.6.1.2.1.1.3.0 for the uptime) and its value, inside an snmp element. For a trap, the peerAddress header is the address of the device that sent it.
Good to know: with type set to TRAP, host and port are the address to listen on, not a device; traps are usually sent to port 162, but port is 161 by default, and a port below 1024 needs administrator rights on most systems. A device that does not answer a poll gives no message: it is sent again retries times, each time after waiting snmpTimeout for the answer; when they are not set, that is 2 more times, after 1.5 seconds each. SNMP v1 and v2c send the community string in clear text; prefer v3 when the device supports it.
Configuration Options
The following table summarizes the configuration options available for the snmp-source Kamelet:
| Property | Name | Description | Type | Default | Example |
|---|---|---|---|---|---|
Host | Required The host name or IP address of the device to poll. With | string | 192.168.1.1 | ||
Authentication Passphrase | The SNMP v3 password of the user, as set on the device. Used with | string | |||
Authentication Protocol | The SNMP v3 hash used to check the login, as set for the user on the device. Used with Enum values: * MD5 * SHA1 | string | |||
Delay | How long to wait between two polls, in milliseconds. For example, 60000 is one minute. Not used for | integer | 60000 | ||
Initial Delay | How long to wait before the first poll, in milliseconds. When it is not set, it is 1000 (one second). Not used for | integer | 10000 | ||
OIDs | The identifiers (OIDs) of the values to read, separated by commas. Required for | string | 1.3.6.1.2.1.1.3.0,1.3.6.1.2.1.25.3.2.1.5.1 | ||
Port | The UDP or TCP port of the device to poll, usually 161. With | integer | 161 | ||
Privacy Passphrase | The SNMP v3 encryption password of the user, as set on the device. Used with | string | |||
Privacy Protocol | The SNMP v3 encryption, such as | string | AES128 | ||
Protocol | The network protocol to use. Most devices use Enum values: * udp * tcp | string | udp | ||
Retries | How many times a poll is sent again when the device does not answer within | integer | 0 | ||
Security Level | The SNMP v3 security level. 1 is no login and no encryption (noAuthNoPriv), 2 is login without encryption (authNoPriv), and 3 is login with encryption (authPriv). Only used with Enum values: * 1 * 2 * 3 | integer | 3 | ||
Security Name | The SNMP v3 user name, as set on the device. Only used with | string | |||
SNMP Community | The community string of SNMP v1 and v2c, which works as a password and is set on the device. It is sent in clear text, so treat it as a secret. | string | public | ||
SNMP Context Name | The SNMP v3 context to read the values from, for a device that serves several sets of values (contexts) under one address, such as one per virtual router. When it is not set, the default context of the device is read. Only used with | string | vrf-blue | ||
SNMP Timeout | How long to wait for the answer of the device to a poll, in milliseconds, before the poll is sent again or given up. When it is not set, it is 1500. Not used for | integer | 5000 | ||
SNMP Version | The version of SNMP to use. 0 is v1, 1 is v2c and 3 is v3. It must match the version the device or the trap sender uses. Enum values: * 0 * 1 * 3 | integer | 0 | ||
Tree List | If true, the values found by | boolean | false | ||
Type | What to do. Enum values: * POLL * GET_NEXT * TRAP | string | POLL |
Dependencies
At runtime, the snmp-source Kamelet relies upon the presence of the following dependencies:
-
camel:snmp
-
camel:kamelet
Camel JBang usage
Prerequisites
-
You’ve installed JBang.
-
You have executed the following command:
jbang app install camel@apache/camel Supposing you have a file named route.yaml with this content:
- route:
from:
uri: "kamelet:snmp-source"
parameters:
.
.
.
steps:
- to:
uri: "kamelet:log-sink" You can now run it directly through the following command
camel run route.yaml SNMP Source Kamelet Description
Modes
Set type to POLL or GET_NEXT to query the OIDs listed in the oids property on a schedule, or to TRAP to listen for traps sent to this host and port.
Polling normally uses port 161 and trap listening normally uses port 162.
Security
SNMP v1 and v2c authenticate with a community string that is sent in clear text, so the snmpCommunity value should be treated as a credential even though it is not encrypted on the wire.
Prefer snmpVersion 3 where the device supports it. securityLevel defaults to 3 (authPriv), which gives both authentication and privacy.
Timeouts and Retries
A device that does not answer a poll gives no message. The poll is sent again retries times, each time after waiting snmpTimeout milliseconds for the answer: 2 more times, after 1.5 seconds each, when they are not set. The first poll starts initialDelay milliseconds after the integration starts, one second when it is not set.
Example with an SNMP v3 Context
A device that serves several sets of values under one address, such as one per virtual router, names each set a context. With SNMP v3, snmpContextName reads the values of one context.
- route:
from:
uri: "kamelet:snmp-source"
parameters:
host: "192.168.1.1"
oids: "1.3.6.1.2.1.1.3.0"
delay: 60000
initialDelay: 10000
snmpTimeout: 5000
retries: 0
snmpVersion: 3
securityName: "monitor"
securityLevel: 2
authenticationProtocol: "SHA1"
authenticationPassphrase: "my-passphrase"
snmpContextName: "vrf-blue"
steps:
- to:
uri: "kamelet:log-sink"