Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Traps for PATROL Agent

 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 }


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*