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

You can also create a link from the integrated product or technology to trace details in BMC Application Diagnostics.

The following topics are presented:

Before you begin

Before you configure and activate integrated technologies, ensure that you review 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.

In the BMC Application Performance Management Console, from the Diagnostics tab, click Administration > Integration Configuration.
In the BMC APM Console Address panel, click the arrow in the upper-right corner and select Edit.
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.
Click Save.
Note
After upgrading
The macro unmigrated-inline-wiki-markup from Confluence is no longer available.
from version 1.3 to 2.0, you must reconfigure the APM console host name manually. See issue DE80058 in Known-and-corrected-issues.

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.

Configure the BMC Application Performance Management Console for integrations.
In the BMC ProactiveNet Integration panel, click the arrow in the upper-right corner and select Edit.
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.}
Click Save.

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.

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).

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.
In the SNMP Integration panel, click the arrow in the upper-right corner and select Edit.
Enter the SNMP connection details:
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).

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.
In the SMTP Integration panel, click the arrow in the upper-right corner and select Edit.
Enter the SMTP connection details:
Click Save.

Configuring Syslog integration

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

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.
In the Syslog Integration panel, click the arrow in the upper-right corner and select Edit.
Enter the Syslog connection details:
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.

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.
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:

Activated switch
Deactivated switch

Configuring BMC Application Diagnostics to integrate with Real User Analyzer

Set the address to point to the the Real User Analyzer instance.

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.
In the Real User Analyzer Address panel, click the arrow in the upper-right corner and select Edit.
Edit the Host Name/IP Address field.
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.