Interpreting SNMP traps

After you configure the SNMP manager and watcher service, the service sends traps for any alarms generated by any watched service (process).

The wdClapiNotification object in the Nuance MIB represents the SNMP trap. It contains five objects:

  • wdnoClapiSeverity—Alarm severity: criticalAlarm, majorAlarm, and minorAlarm.
  • wdnoClapiMessageId—Event ID of the alarm in Management Station. Not applicable for SNMP. View the alarm in Management Station for the description and action to take.
  • wdnoClapiMessage—Complete message produced by the service subsystem. Includes key information like the time at which the alarm occurred, the host on which the alarm occurred, the service generating the alarm, and a debug trace. The debug trace may consist of some or all of these fields, separated by semi-colons:
    • Org–ID: The company name, for example, CompanyA.
    • App–ID: The application name, for example, Weather.
    • DNIS: Dialed Number Identification Service. The dialed number or sip: URI of the incoming call. Some examples are 5551212, 16505551212, sip:5551212@nvp_host:port.
    • SIP–CallID: Call ID of the SIP incoming call. For example: MTI1YjQ1MDI0Nzg5MmQ4NDgxZTVkNzMzNWFiNmM3MmE. See RFC 3261.
    • Text: Explains the reason for the alarm, for example, Can not collect data, directory.

Field

Description

Version

The message of the version, currently 20.

Session ID

Globally unique identifier for the current call session. The session ID value is a hexadecimal representation indicating:

  • Host IP address—IP address of the machine answering the call
  • Process ID—OS-specific identifier
  • Timestamp—Number of seconds elapsed since Jan. 1, 1970
  • Instance—Per-process identifier
  • Channel ID—Application-specific value (zero, if automatically generated)

For example: 0a650051_00000153_3ba8ecf6_0001_0000

If the session ID is not available, it appears as “-” in the display.

Category

Message classification, currently LOG.

Level

Logging level for the message, for example, MINOR_ALARM. Equals wdnoClapiSeverity.

Event ID

Unique identifier for a particular message, for example, 10027013. Not applicable for SNMP. When clicked in Management Station Alarms table, displays details about the message, including possible actions to correct the problem.

Equals wdnoClapiMessageId.

Time

Date and time (based on a 24-hour clock) the message was generated. The format is: 

YYYY-MM-DD hour:minutes:seconds.milliseconds

For example: 20012-10-22 18:07:47.559.

Host

Host where the event occurred, for example, bluebird.

Service

Service or user application that generated the message, for example, fta.

Service ID

Unique identifier for the service that generated the message, for example, 651d3ab1-0a03-13b4-008d-e4627dd854c6.

Thread ID

Identifier assigned by the operating system to each running thread of a service, for example, 6116.

Service Subsystem

Internal component name that generated the message, for example, FTS.

Internal Source

Class name, method name or line number where the message was generated, for example, FTS.

Message length

Message length in bytes, for example, 148.

Message text

Consists of these components separated by semi-colons:

  • Org–ID: Company value specified on the voice browser service Applications tab, for example, CompanyA.
  • App–ID: Application value specified on the voice browser service Applications tab, for example, Weather.
  • DNIS: Dialed Number Identification Service. The dialed number or sip: URI of the incoming call. Some examples are 5551212, 16505551212, sip:5551212@nvp_host:port.
  • SIP–CallID: Call ID of the SIP call coming into the telephony session service. For example: MTI1YjQ1MDI0Nzg5MmQ4NDgxZTVkNzMzNWFiNmM3MmE. See RFC 3261.
  • Text: Explains the reason for the alarm, for example, Can not collect data, directory.
  • wdnoClapiHostName—Hostname of the machine running the service that generated the alarm.
  • wdnoClapiServiceName—Name of the service that generated the alarm.

Here is an example to illustrate the contents of an SNMP trap. This example assumes that a Nuance service, the file transfer service, is running on a managed host called bluebird.

Upon request, the file transfer service transfers call log files from the host to Management Station. If the path for the call log files is incorrect, file transfer service generates an alarm that is sent to Management Station. Because the watcher service is configured to send out SNMP traps, a corresponding SNMP trap is sent to the SNMP Manager.

The SNMP trap represented by the wdClapiNotification object contains these values:

  • wdnoClapiSeverity—Value set to minorAlarm, meaning the problem doesn’t need to be addressed immediately. Often minor alarms are self-correcting.
  • wdnoClapiMessageID—Value set to 10027013. Refers to the alarm’s Event ID in Management Station and is not applicable for SNMP. The Event ID links to a message catalog that provides probable causes and actions to take.
  • wdnoClapiMessage—Value set to: 
    20,-,LOG,MINOR_ALARM,10027013,2009-05-22 18:07:47.559,bluebird,fta,651d3ab1-0a03-13b4-008d-e4627dd854c6
    ,6116,FTS,FTS,148,Org-ID=CompanyA;App-ID=Weather;DNIS=sip:5551212@nvphost:9121;SIP-CallID=MTI1YjQ1MDI0Nzg5MmQ4NDgxZTVkNzMzNWFiNmM3MmE;Can not collect data, directory.>>>1.0>>>c:/jskg

    This message provides the following information (only key information displayed):

    Information

    Value

    Alarm level

    MINOR_ALARM

    Time of the alarm

    2009/03/15 12:37:14.172

    Host on which the alarm occurred

    bluebird

    Name of the service that generated the alarm

    fta

    Debug trace

    Org-ID=CompanyA;App-ID=Weather;DNIS=sip:5551212@nvphost:9121;SIP-CallID=MTI1YjQ1MDI0Nzg5MmQ4NDgxZTVkNzMzNWFiNmM3MmE;Can not collect data, directory.

  • wdnoClapiHostName—Value set to bluebird, the host on which this alarm was raised.
  • wdnoClapiServiceName—Value set to fta, the service that generated the alarm.