SNMP trap keys

When an SNMP trap is received in IBM® Maximo® Real Estate and Facilities, it creates an Asset SNMP Trap record only if the SNMP Trap record includes the key string “triTREESExternalRule”.

SNMP traps include variables which have values. The names of the variables are not controlled by Maximo Real Estate and Facilities. Maximo Real Estate and Facilities stores all of the required information from an SNMP trap in one variable or string as pairs where key = value.

For example, one of the variables may have the following string value: triTREESExternalRule, triName = Simultaneous Heating and Cooling, triNameplate =abc123, triPriority =High, triDescription =AHU is Heating and Cooling at the same time”, triResolution=Check AHU setting

Without the key string "triTREESExternalRule", Maximo Real Estate and Facilities will not create an Asset SNMP Trap record.

The following table contains more information about each of the keys.

Table 1. SNMP trap keys
Key Value Comments
triTREESExternalRule Required. Since SNMP traps can be used by other objects in Maximo Real Estate and Facilities, the triTREESExternalRule key indicates that this message should be processed for analytics.
triName Required. The name of the event.  
triNameplate Required. The nameplate of the device. The Nameplate value must exist in Maximo Real Estate and Facilities as an Asset (Building Equipment).
Maximo Real Estate and Facilities workflow will use the Nameplate to identify the asset that triggered this analytic event and requires attention.
triDescription Required. Description of the analytic rule conditions that trigger this event.  
triPriority Optional. The priority of this event. Used when creating a service request. You can set a default SNMP priority in the Application Settings.
triResolution Optional.