General getDeviceData documentation; supported events.

Supported incoming events

Name runNetbox
Eventtype notification
Description Send this event to request collection of SNMP data for a device
Related events runNetboxDone
Eventq fields Description Required
deviceid Device to collect from No
netboxid Netbox to collect from Yes
subid Copied to the runNetboxDone event if present; use this to differenciate answer events. No
state This event is stateless No
value Not used No
severity Not used No
Supported variables
maxage Maximum age, in seconds, of collected data; any data older than this will be collected. If not present, 0 is assumed. No
oidkeys Comma-separated list of oidkeys to collect. If not present, all are collected. No

Supported outgoing events

Name runNetboxDone
Eventtype notification
Description Sent as response to a runNetbox event when processing is finished.
Related events runNetbox
Eventq fields Description Always present
deviceid Device collected from Yes
netboxid Netbox collected from Yes
subid Copied from the runNetbox event if present there No
state This event is stateless No
value Not used No
severity Not used No
Supported variables
age Age, in seconds, of oldest collected data. Yes

Eventtype deviceHwUpgrade
Description Sent when a netbox changes type and is recreated.
Related events  
Eventq fields Description Always present
deviceid Device collected from Yes
netboxid Netbox collected from Yes
subid Not used No
state This event is stateless No
value Not used No
severity Not used No
Supported variables
oldtype The name of the old type. Yes
newtype The name of the new type. Yes

Eventtype info
Description Sent when the sysname and DNS record of a netbox do not correspond.
Related events  
Eventq fields Description Always present
deviceid Device collected from Yes
netboxid Netbox collected from Yes
subid Not used No
state This event is stateless No
value Not used No
severity Not used No
Supported variables
dnsname The DNS name of the netbox. Yes
sysname The sysname of the netbox. Yes

Eventtype deviceHwUpgrade
Description Sent when the serial number of a device changes.
Related events  
Eventq fields Description Always present
deviceid Device collected from Yes
netboxid Netbox collected from Yes
subid Not used No
state This event is stateless No
value Not used No
severity Not used No
Supported variables
old_deviceid The old deviceid of the device the changes apply to. Yes
new_deviceid The new deviceid of the device the changes apply to. Yes
old_serial The old serial number of the device the changes apply to. Yes
new_serial The new serial number of the device the changes apply to. Yes

Eventtype deviceHwUpgrade
Description Sent when the hardware version of a device changes.
Related events  
Eventq fields Description Always present
deviceid Device collected from Yes
netboxid Netbox collected from Yes
subid Not used No
state This event is stateless No
value Not used No
severity Not used No
Supported variables
deviceid The deviceid of the device the changes apply to. Yes
old_hwver The old hardware version of the netbox. Yes
new_hwver The new hardware version of the netbox. Yes

Eventtype deviceSwUpgrade
Description Sent when the software version of a device changes.
Related events  
Eventq fields Description Always present
deviceid Device collected from Yes
netboxid Netbox collected from Yes
subid Not used No
state This event is stateless No
value Not used No
severity Not used No
Supported variables
deviceid The deviceid of the device the changes apply to. Yes
old_swver The old software version of the netbox. Yes
new_swver The new software version of the netbox. Yes