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 |