Integrating end-user experience monitoring alerts to TrueSight Infrastructure Management using SNMP traps

You can configure event integration between passive end-user experience monitoring and TrueSight Infrastructure Management. This event integration uses Real End User Experience Monitoring Software Edition to send SNMP traps in response to passive end-user experience monitoring system alerts and incidents.

The TrueSight Infrastructure Management event management server can receive the SNMP traps and present the events' details in the TrueSight console.

When a threshold is exceeded or an event is detected, Real End User Experience Monitoring Software Edition sends an SNMP trap with information, such as severity, host, IP Address, and Watchpoint name. The trap information is mapped to slots in a TrueSight Infrastructure Management cell.

The following information describes how to:

  • Configure a TrueSight Infrastructure Manager cell to receive SNMP traps from Real End User Experience Monitoring Software Edition.
  • Enable Real User Experience Monitoring Software Edition to send system and incident alerts using SNMP traps to the TrueSight Infrastructure Management server.

Before you begin

Install the following products:

Integration components for Real End User Experience Monitoring Software Edition to TrueSight Infrastructure Management

When you extract the TSIM-EUEM-Events-Integration.zip archive, you will see the following file hierarchy:

TSIM_files

-- map

‘—mcsnmptrapd.map
‘—mcsnmptrapd.dat
-- classes
‘—mcsnmptrapdmib.baroc
‘—mcsnmptrapdmibe.baroc
-- rules
‘—euem_refine.mrl
-- collectors
‘—euem_collectors.mrl

You will use these files to add the Real End User Experience Monitoring Software Edition events integration to the TrueSight Infrastructure Management server.

To configure the TrueSight Infrastructure Management server for SNMP events

The following files are required in the TrueSight Infrastructure Management server so Real End User Experience Monitoring Software Edition events can be integrated in the server.

To complete the configuration process, you will need the class, map, rule, and collector files and then complete the compilation process.

Note

For the following class, map, rule, and collector files configuration instruction:

  • The directory paths include the default location under the %BMC_PROACTIVENET_HOME% root directory.
  • The <cell_name> variable must be replaced with the actual TrueSight Infrastructure Management cell name.

Map file

The map files are used to:

  • Designate how the parsed Real End User Experience Monitoring Software Edition SNMP trap data is mapped to slots within TrueSight console
  • Filter out unwanted events.
  • Change data in the source event.

To use these map files, copy the mcsnmptrapd.map and mcsnmptrapd.dat files from the TSIM-EUEM-Events-Integration.zip archive to the following directory:

%BMC_PROACTIVENET_HOME%\server\etc

Class files

You use the class files to define the field (slot) names to names that the TrueSight Infrastructure Management server can identify.

To use the class files:

  1. From the extracted TSIM-EUEM-Events-Integration.zip archive, copy the following files to %BMC_PROACTIVENET_HOME%\server\etc\<cell_name>\kb\classes:
    mcsnmptrapdmibe.baroc 
    mcsnmptrapdmib.baroc
  2. Open the .load file located in:
    %BMC_PROACTIVENET_HOME%\server\etc\<cell_name>\kb\classes\
  3. At the bottom of the file, add the following lines:
    mcsnmptrapdmibe
    mcsnmptrapdmib
  4. Save and close the .load file.

Rule file

It is necessary to define a rule to set dynamic values to event slots, such as severity, message, and monitoring tool URL.

To define a rule file:

  1. From the extracted TSIM-EUEM-Events-Integration.zip archive, copy the euem_refine.mrl file extracted from the integration archive file to %BMC_PROACTIVENET_HOME%\server\etc\<cell_name>\kb\rules.
  2. Open the .load file in %BMC_PROACTIVENET_HOME%\server\etc\pncell_<hostname>\kb\rules\ and add euem_refine before mc_sm_start and mc_sm_associate.
  3. Save the .load file.

Collectors file

To configure the Real User Collector to send SNMP traps to the TrueSight Infrastructure Manager server, complete the following:

  1. From the extracted TSIM-EUEM-Events-Integration.zip archive, copy the euem_collectors.mrl file extracted from the integration archive file to %BMC_PROACTIVENET_HOME%\server\etc\<cell_name>\kb\collector.
  2. Open the .load file in %BMC_PROACTIVENET_HOME%\server\etc\pncell_<hostname>\kb\collector\ and add euem_collectors at the end of the file.
  3. Save the .load file.

Compilation process

After you have configured all of the files, you must run the compilation process:

Note

For Linux systems, the MCELL_HOME variable must be defined. If this variable is undefined, set it to %BMC_PROACTIVENET_HOME%/server.

Do not proceed with the compilation process if this variable is undefined.

  1. Open a command prompt, navigate to %BMC_PROACTIVENET_HOME%\server\etc\pncell_<hostname>\kb, and enter:
    "%BMC_PROACTIVENET_HOME%\server\bin\mccomp.exe" manifest.kb
  2. Verify there are no errors in the compilation output.
  3. Restart the server TrueSight Infrastructure Management server.

When the configuration is completed for TrueSight Infrastructure Manager to receive Real End User Experience Monitoring Software Edition events, you must registering the Real User Analyzer as a componentin the TrueSight Presentation Server. Once the Real User Analyzer is a registered component, the TrueSight console can present the alerts.

The TrueSight Infrastructure Management event management server receives the SNMP traps and presents the system and incident alerts' details in the TrueSight console.

To enable Real User Experience Monitoring Software Edition to send SNMP traps

To configure Real User Experience Monitoring Software Edition to send send system and incident alerts using SNMP traps to the TrueSight Infrastructure Management server, complete the following:

Note

To perform this procedure, you must have Operator-level access, or higher.

  1. In the Real User Analyzer interface, point to Administration > Integration, and click Network management (SNMP).
  2. In the Traps section, click ON.
  3. From the Action menu for the Traps section, select Edit and enter the TrueSight Infrastructure Manager IP address in the Trap manager address field.
    SNMP_edit_traps.png

To enable sending SNMP traps for system alerts

  1. To configure the Real User Analyzer to send SNMP traps for system alerts, point to Administration > General settings, and click System alerts.
  2. Click ON in the Traps alerts section.

To enable sending SNMP traps on incidents

  1. To configure the Real User Analyzer to send SNMP traps on incidents, point to Administration > Threshold and problem detection and click Incident detection.
  2. To see all of the rules, click the total number in right lower corner of the table:
    rules-all.png
  3. In the list of rules, click the shortcut menu for the rule you want to configure for SNMP trap notification, and select Edit.
  4. On the rule page, select the Notification tab.
  5. In the Notify when critical section, select Send SNMP trap.
    notification_incident.png
  6. Click Save.

The system begins sending notifications via SNMP whenever an incident for the selected rule has an urgency rating value that is equal to, or greater, than the value entered in the When urgency rating is ... or higher field.

Related topics

Integrating

Configuring-trap-based-alerts-through-SNMP

Configuring-incident-notifications-on-the-Analyzer

 

 

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