User guide

Built-in Browsers - SNMP MIB and CWMP Trap Parser
965
AlliedView NMS Administration Guide
• Enterprise OID - The enterprise field is the SNMP enterprise identifier in the trap, which is used to uniquely identify traps
for a particular application. The parser is applied only when the trap enterprise field starts with the enterprise field you
specify. The only exception is that when the enterprise field is left blank, the trap is allowed to be parsed.
• OID and Value - This extends the match criteria. There must be a match for all the OID:Value pairs (specified in the list
box) in the Trap PDU of the receiving trap.
• Agent and Port - This also extends the match criteria. The trap must be sent by an Agent specified in the Agent:Port list
box. If the Port is 0, then the source can send the trap from any port.
For each match criterion, a name is given called the Trap Name. The fields in the event details are configured in the Output
Event Parameters section. Once the Trap is matched by the match criteria, the trap is added to the Trap Table. The Output
Event parameters are shown as the Trap Details, which gives more specific information regarding the trap.
By default, some of the field of the Output Event parameters are filled by a variable called parser variables, usually starting
with $. These variables substitute a specific characteristic of the parser in the Trap Details.
Values for field are:
• $Community - This token is replaced by the community string of the received trap.
• $Source - This token is replaced by the source name/address of the received trap.
• $Enterprise - This token is replaced by the enterprise ID of the received trap.
• $Agent - This token is replaced by the agent address of the received trap.
• $SpecificType - This token is replaced by the specific type of the received trap.
• $GenericType - This token is replaced by the generic type of the received trap.
• $Uptime - This token is replaced by the uptime value in the received trap.
• $* - This token is replaced by all the variable bindings of the received trap, including the OID and the variable values of
each variable binding.
• $# - This token is replaced by all the SNMP variable values in the variable bindings of the received trap.
• $N - This token is replaced by the (N-1) SNMP variable value in the variable bindings of the received trap.
• @* - This token is replaced by all the OID values in the variable bindings of the received trap.
• @N - This token is replaced by the (N-1) OID value in the variable bindings of the received trap.
11.8.2 Procedure to Create a Parser File
1. Click ParserEditor in the Trap Viewer.
2. Enter the Match Criteria, which includes Trap Parser Name, Generic Type, Specific Type, Enterprise OID, OID and Value
pair (optional) and Agent and port pair (optional). (The Generic Type - means, it will match any value for this field).
3. Click the OutPut Event Parameters tab and fill in the event parameters. These include Severity, Failure Object,
Community, Node, Source, Help URL, Message, and Severity Color. If left blank, the following fields will default as
follows:
• Community - Name
• Node - $Source
• Source - $Source
• Help URL - $GenericType-$SpecificType.html
• Message - $*
4. Click Add to add the Trap parser to the Parser List.
5. Repeat from Step 1 to add more Match Criteria for incoming Traps.
6. Save the current parser criteria into a parser file using the Save button.
7. After saving, the parser file is displayed on the Parser File text field.