Configuring and activating integrated technologies

You can configure integrations for supported products and technologies. With integrated products and technologies, you can view events and event notifications from BMC Application Diagnostics.

You can send the following kinds of events:

• Application events, such as crossing a latency threshold and percentage of errors
• Application server events, such as JMX metrics, thread pools, and connection pools
• System health events, such as issues with BMC Application Diagnostics agents, collectors or the portal

Except where noted, events that are sent to the integrated product or technology contain a hyperlink to trace details in BMC Application Diagnostics.

The following topics are presented:

• • Before you begin
  • Configuring the BMC Application Performance Management Console for integrations
  • Integrating with BMC ProactiveNet
  • Configuring monitoring over SNMP
  • Configuring notification with SMTP
  • Configuring Syslog integration
  • Write events to a CSV file
  • Activating and deactivating integrations
  • Configuring BMC Application Diagnostics version 2.1.00 integration with Real User Analyzer
  • Configuring BMC Application Diagnostics version 2.1.01 integration with BMC Real End User Experience Monitoring
  • Integrating with external monitoring applications
  • Related topic

Before you begin

Before you configure and activate integrated technologies, ensure that you review the following topics:

• User-roles
• Known-and-corrected-issues

Configuring the BMC Application Performance Management Console for integrations

For any integrated technology, configure the BMC Application Performance Management Console for integrations. The following procedure to defines the properties of the console address so that integrated products can link to BMC Application Diagnostics.

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

1. In the BMC Application Performance Management Console, from the Diagnostics tab, click Administration > Integration Configuration.
2. In the BMC APM Console Address panel, click the arrow in the upper-right corner and select Edit.
3. Enter the console details:
   • Host Name / IP Address: Host name or IP address of the console computer
   • Port: Listening port on the console computer. The default value is 443.
4. Click Save.

Integrating with BMC ProactiveNet

Perform the following procedure to configure the BMC Application Diagnostics Server to send events to BMC ProactiveNet. BMC ProactiveNet Cells are event-processing engines that store all events and data in memory and on disk. If the BMC ProactiveNet Cell is in high-availability mode, enter the secondary BMC ProactiveNet Cell information.

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

1. Configure the BMC Application Performance Management Console for integrations.
2. In the BMC ProactiveNet Integration panel, click the arrow in the upper-right corner and select Edit.

3. Enter the BMC ProactiveNet connection details:

   The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
   ^{1 If the BMC ProactiveNet Cell is in high-availability mode, enter the secondary BMC ProactiveNet Cell information. Otherwise, leave these fields blank.}

4. Click Save.

In addition to seeing diagnostics data in the events views of BMC ProactiveNet, BMC Application Diagnostics integration can show events in defined services. You can include the agent and monitored services in a service model, and in this way, gain a better understanding of the impact of the event on your monitored service. For details about service modeling, see BMC ProactiveNet online technical documentation.

Configuring monitoring over SNMP

Perform the following procedure to configure the BMC Application Diagnostics Server to send events using Simple Network Management Protocol (SNMP).

To perform this procedure, you must have Administrator-level access, or higher, or have tenant Application Owner-level access.

1. Configure the BMC Application Performance Management Console for integrations.
2. In the SNMP Integration panel, click the arrow in the upper-right corner and select Edit.

3. Enter the SNMP connection details:
4. Click Save.

Configuring notification with SMTP

Perform the following procedure to configure the BMC Application Diagnostics Server to send email notification of events using Simple Mail Transfer Protocol (SMTP).

To perform this procedure, you must have Administrator-level access, or higher, or have tenant Application Owner-level access.

1. Configure the BMC Application Performance Management Console for integrations.
2. In the SMTP Integration panel, click the arrow in the upper-right corner and select Edit.

3. Enter the SMTP connection details:
4. Click Save.

Configuring Syslog integration

Perform the following procedure to configure the BMC Application Diagnostics Server to send events to syslog.

To perform this procedure, you must have Administrator-level access, or higher, or have tenant Application Owner-level access.

1. Configure the BMC Application Performance Management Console for integrations.
2. In the Syslog Integration panel, click the arrow in the upper-right corner and select Edit.

3. Enter the Syslog connection details:
4. Click Save.

Write events to a CSV file

By default, the server writes to a comma-separated values (CSV) file, events.csv, located on the BMC Application Diagnostics Portal computer, in the <installationDirectory>\portal\logs\events directory. Events in the CSV file do not contain hyperlinks to the trace details in BMC Application Diagnostics.

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

1. Configure the BMC Application Performance Management Console for integrations.
2. In the CSV Event Logging panel, click the switch to disable or enable the BMC Application Diagnostics Server to write events to the CSV file.

Activating and deactivating integrations

After you configure an integration, you can click the switch to activate or deactivate the feature.

To perform this procedure, you must have Administrator-level access, or higher, or have tenant Application Owner-level access.

• Activated switch
• Deactivated switch

Configuring BMC Application Diagnostics version 2.1.00 integration with Real User Analyzer

Direct BMC Application Diagnostics to point to a Real User Analyzer instance.

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

1. Configure the BMC Application Performance Management Console for integrations.
2. In the Real User Analyzer Address panel, click the arrow in the upper-right corner and select Edit.
3. Enter the Host Name/IP Address for the Real User Analyzer.
4. Click Save.

Configuring BMC Application Diagnostics version 2.1.01 integration with BMC Real End User Experience Monitoring

Direct BMC Application Diagnostics to point to BMC Real End User Experience Monitoring, either with the Session Overview page of the Performance Analysis feature, or the Session Browser page of a Real User Analyzer instance.

To perform this procedure, you must have Administrator-level access, or higher, or have tenant Application Owner-level access.

1. Configure the BMC Application Performance Management Console for integrations.
2. In the BMC Real End User Experience Monitoring Integration panel, click the arrow in the upper-right corner and select Edit.
3. Select the kind of integration:
   • No Integration. BMC Application Diagnostics is not integrated with BMC Real End User Experience Monitoring.

   • Session Overview (Performance Analysis). BMC Application Diagnostics is integrated with the Performance Analysis feature.
     Clicking the View in EUEM button in the Trace Details window opens the Session Overview page, in the Object Overview section .

   • Session Browser (Real User Analyzer). BMC Application Diagnostics is integrated with the Real User Analyzer feature.

     • If BMC Application Diagnostics is configured for on-premises use (that is, without tenant configuration), then you must enter the host name or IP address for the Real User Analyzer.
     • If BMC Application Diagnostics is configured for SaaS, then the Real User Analyzer configuration was specified during tenant configuration.

     Clicking the View in EUEM button in the Trace Details window opens the Session Browser page in the Real User Analyzer console.

4. Click Save.

Integrating with external monitoring applications

If you use an external monitoring application, then BMC Application Diagnostics can provide a detailed view of specially tagged transactions. Transactions with matching tags are persisted, regardless of sampling or thresholds configuration.

For details, see Configuring-persistence-of-tagged-transactions.

Related topic

Working-with-logs