Traps for PATROL Agent
The PATROL Agent sends traps to registered SNMP managers in V1 format only.
- To register an SNMP manager with the PATROL Agent, add the manager to a row in the piV1mTable.
- To add the manager, send an instance of piV1mRowStatus for the desired ip/port/community with a value of CreateAndGo (4).
- To delete the manager, set its value to Delete (6).
The PATROL Agent sends two types of traps as follows:
- patrolTrapV1StateChanged is sent to all registered SNMP managers when an application instance state changes.
- patrolTrapV1Raised is sent to registered SNMP managers when a PSL snmp_raise_std_trap( ) is called.
The object patrolTrapText carries text passed with the trap. For patrolV1TrapRaised, the value of patrolTrapText.0 is defined by the PSL program as the only parameter for the snmp_trap_raise_std_trap( ) function. For patrolV1TrapStateChanged, the value of patrolTrapText.0 is a string PATROL_OBJECT_NAME NEW_STATUS or PATROL_OBJECT_NAME NEW_STATUS NEW_VALUE (PATROL parameters).
Enterprise-specific 1 to 9 are reserved.
patrolTrapV1Raised TRAP-TYPE
ENTERPRISEpatrolTraps
OBJECTS{patrolTrapText}
DESCRIPTION "A patrolTrapV1Raised trap is sent when one of the PSL scripts calls the snmp_raise_std_trap function. This trap is sent to the SNMP V1 entity according to piV1mTable."
: := 10
patrolTrapV1StateChanged TRAP-TYPE
ENTERPRISEpatrolTraps
OBJECTS{variableValue}
DESCRIPTION "A patrolTrapV1StateChanged is sent when the PATROL Agent changes the state of the discovered application instances. This trap is sent to the SNMP V1 entity according to piV1mTable."
: := 11
patrolTrapText OBJECT-TYPE
SYNTAXOCTET STRING (SIZE (0..127))
ACCESSread-only
STATUSmandatory
DESCRIPTION "String passed by PSL to inform the agent about the trap reason"
: := { patrolTraps 9 }
patrolTrapOrigin OBJECT-TYPE
SYNTAXOCTET STRING (SIZE (0..127))
ACCESSread-only
STATUSoptional
DESCRIPTION "Name of the object that originated the trap"
: := { patrolTraps 10}
patrolTrapExtra OBJECT-TYPE
SYNTAXOCTET STRING (SIZE (0..127))
ACCESSread-only
STATUSoptional
DESCRIPTION "Extra information, usually parameter value"
: := {patrolTraps 11 }