Enabling SNMP Traps
Enabling and configuring SNMP traps
To enable SNMP traps for your site, log in to your SputnikNet and browse to ACCOUNT > Settings > Notifications.
The configurable fields are as follows:
SNMP Notifications: When checked, Sputnik will send traps to your SNMP server
SNMP Server: The IP address or host name of a an SNMP server accessible on a public IP address. If you are a Sputnik reseller and have made alternate transport arrangements in advance, this need not be a publicly accessible address.
Event Type: An SNMP event will be sent for each of the selected events which are:
- New Device: A previously unseen node (router/access point) has come online
- Inactive: A node has gone offline.
- Active: A previously seen node has come online.
- IP Change: A previously seen node has changed its IP address.
- Warning: An error has occurred.
Inactive Delay: SputnikNet normally waits 600 seconds before declaring a node inactive. This delay causes SputnikNet to wait an additional amount of seconds before declaring the node inactive.
Host Name Prefix: the node name specified in the router configuration (i.e. “New York Hot Spot #1”). This name is reported as part of the SNMP trap. The value specified here will be added to the front of the node name.
Host Name Postfix: Same as the prefix, but added to the end of the node name rather than the front.
Press the update button to commit your changes.
SNMP trap details
Message - newNode
This trap is sent when a new router has come online for the first time
OID: 1.3.6.1.4.1.8714.99.8714.0.2
Fields
1.3.6.1.4.1.8714.99.8714.1.1 s '$host'
1.3.6.1.4.1.8714.99.8714.1.2 s '$node_ip'
1.3.6.1.4.1.8714.99.8714.1.3 s '$timestamp'
1.3.6.1.4.1.8714.99.8714.1.4 s '$message'
1.3.6.1.4.1.8714.99.8714.1.5 s '$jid'
1.3.6.1.4.1.8714.99.8714.1.6 i 2
1.3.6.1.4.1.8714.99.8714.1.7 s '$customer'
1.3.6.1.4.1.8714.99.8714.1.8 s '$location'
1.3.6.1.4.1.8714.99.8714.1.9 s '$long_message'
MIB Definitions for nodeDown:
- Host: the name of the node in question, including the prefix and postfix specified in the account configuration.
- Node IP: the router's LAN IP (e.g. 192.168.190.122)
- Timestamp: the date and time of the event where time is spoecified in the 24 hour format (e.g. "Thu October 03, 2013 14:22:10 -7")
- Message: The string “newNode”.
- JID: The unique identifier of the node in question used internally by SputnikNet
- Customer: The name of the customer account
- Location: The location of the router as specified in its configuration
- Long Message: The string “New Access Point. Please visit the following URL to configure it: “ followed by the URL of the configuration page.
Message - nodeDown
This trap is sent when the node has gone offline.
OID: 1.3.6.1.4.1.8714.99.8714.0.1
Fields
1.3.6.1.4.1.8714.99.8714.1.1 s '$host'
1.3.6.1.4.1.8714.99.8714.1.2 s '$node_ip'
1.3.6.1.4.1.8714.99.8714.1.3 s '$timestamp'
1.3.6.1.4.1.8714.99.8714.1.4 s '$message'
1.3.6.1.4.1.8714.99.8714.1.5 s '$jid'
1.3.6.1.4.1.8714.99.8714.1.6 i 2
1.3.6.1.4.1.8714.99.8714.1.7 s '$customer'
1.3.6.1.4.1.8714.99.8714.1.8 s '$location'
1.3.6.1.4.1.8714.99.8714.1.9 s '$long_message'
MIB Definitions for nodeDown:
- Host: the name of the node in question, including the prefix and postfix specified in the SNMP configuration.
- Node IP: the router's LAN IP (e.g. 192.168.190.122)
- Timestamp: the date and time of the event where time is spoecified in the 24 hour format (e.g. "Thu October 03, 2013 14:22:10 -7")
- Message: The string “nodeDown”
- JID: The unique identifier of the node in question used internally by SputnikNet
- Customer: The name of the customer account
- Location: The location of the router as specified in its configuration
- Long Message: Describes the event in english and provides a link to the router's status page.
Message - nodeDownClear
This trap is sent when the node has come back online after a nodeDown event.
OID: 1.3.6.1.4.1.8714.99.8714.0.3
Fields
1.3.6.1.4.1.8714.99.8714.1.1 s '$host'
1.3.6.1.4.1.8714.99.8714.1.2 s '$node_ip'
1.3.6.1.4.1.8714.99.8714.1.3 s '$timestamp'
1.3.6.1.4.1.8714.99.8714.1.4 s '$message'
1.3.6.1.4.1.8714.99.8714.1.5 s '$jid'
1.3.6.1.4.1.8714.99.8714.1.6 i 2
1.3.6.1.4.1.8714.99.8714.1.7 s '$customer'
1.3.6.1.4.1.8714.99.8714.1.8 s '$location'
1.3.6.1.4.1.8714.99.8714.1.9 s '$long_message'
MIB Definitions for nodeDown:
- Host: the name of the node in question, including the prefix and postfix specified in the account configuration.
- Node IP: the router's LAN IP (e.g. 192.168.190.122)
- Timestamp: the date and time of the event where time is spoecified in the 24 hour format (e.g. "Thu October 03, 2013 14:22:10 -7")
- Message: The string “nodeDown”. This is a known bug and will be changed to “nodeDownClear” in future.
- JID: The unique identifier of the node in question used internally by SputnikNet
- Customer: The name of the customer account
- Location: The location of the router as specified in its configuration
- Long Message: The string “Node UP: “ followed by a link to the router's status page.
Message - IPChanged
This trap is sent when a router changes its IP address
OID: 1.3.6.1.4.1.8714.99.8714.0.5
Fields
1.3.6.1.4.1.8714.99.8714.1.1 s '$host'
1.3.6.1.4.1.8714.99.8714.1.2 s '$node_ip'
1.3.6.1.4.1.8714.99.8714.1.3 s '$timestamp'
1.3.6.1.4.1.8714.99.8714.1.4 s '$message'
1.3.6.1.4.1.8714.99.8714.1.5 s '$jid'
1.3.6.1.4.1.8714.99.8714.1.6 i 2
1.3.6.1.4.1.8714.99.8714.1.7 s '$customer'
1.3.6.1.4.1.8714.99.8714.1.8 s '$location'
1.3.6.1.4.1.8714.99.8714.1.9 s '$long_message'
MIB Definitions for nodeDown:
- Host: the name of the node in question, including the prefix and postfix specified in the account configuration.
- Node IP: the router's LAN IP (e.g. 192.168.190.122)
- Timestamp: the date and time of the event where time is spoecified in the 24 hour format (e.g. "Thu October 03, 2013 14:22:10 -7")
- Message: The string “nodeIpChanged”.
- JID: The unique identifier of the node in question used internally by SputnikNet
- Customer: The name of the customer account
- Location: The location of the router as specified in its configuration
- Long Message: The string “Ip Changed for this node. “ followed by the URL of the node status page.
Message - nodeGenericError
This trap is sent for errors conditions where another message type does not apply.
Note: This message type is defined, but not currently in use.
OID: 1.3.6.1.4.1.8714.99.8714.0.4
Fields
1.3.6.1.4.1.8714.99.8714.1.1 s '$host'
1.3.6.1.4.1.8714.99.8714.1.2 s '$node_ip'
1.3.6.1.4.1.8714.99.8714.1.3 s '$timestamp'
1.3.6.1.4.1.8714.99.8714.1.4 s '$message'
1.3.6.1.4.1.8714.99.8714.1.5 s '$jid'
1.3.6.1.4.1.8714.99.8714.1.6 i 2
1.3.6.1.4.1.8714.99.8714.1.7 s '$customer'
1.3.6.1.4.1.8714.99.8714.1.8 s '$location'
1.3.6.1.4.1.8714.99.8714.1.9 s '$long_message'
MIB Definitions for nodeDown:
- Host: the name of the node in question, including the prefix and postfix specified in the account configuration.
- Node IP: the router's LAN IP (e.g. 192.168.190.122)
- Timestamp: the date and time of the event where time is spoecified in the 24 hour format (e.g. "Thu October 03, 2013 14:22:10 -7")
- Message: The string “nodeError”.
- JID: The unique identifier of the node in question used internally by SputnikNet
- Customer: The name of the customer account
- Location: The location of the router as specified in its configuration
- Long Message: The string “An error has been detected. Please visit the following URL to configure it: <url> - Error message: <error>” where <url> is the node configuration page and <error> is an English description of the problem.