Connect DX APM to Application Delivery Analysis
DX APM
to Application Delivery Analysisdxapm111
Connecting
DX APM
to ADA allows you to view infrastructure data on APM WebView. Enterprise Manager periodically calls web services on the ADA Manager for these metrics and renders them on APM WebView. Enterprise Manager also stores these metrics in the SmartStor for historical reporting.As an administrator, perform the following steps:
Prerequisites
Before you begin, verify that you have installed and configured:
- CA Application Delivery Analysis 9.1 or newer
- NPC 6.1/CAPC 2.0
- APM database 9.1 or newer
- Enterprise Manager 9.1 or newer
- DX APMWorkstation 9.1 or newer
- DX APMWebView (optional)
- Oneof the following:
- DX APM.NET agent 9.0 or newer
- DX APMJava agent 9.0 or newer
Run the Installer Program
The
DX APM
Integration for ADA installer program contains two installable components, CAPC Integration Pack and ADA Extension for APM. Instructions in this section show you how to install the ADA Extension for APM. This installable component enables communication between ADA and DX APM
.Install the installable component on the Enterprise Manager or MOM (if you have a clustered
DX APM
environment).You need the following information to complete the installation:
- Enterprise Manager host name
- Enterprise Manager port number
- Host name or IP address of the servers to which the ADA Extension for APM installable component connects
Follow these steps:
- Download theDX APMIntegration for ADA installer program from theDX APMsoftware download area on support.
- Navigate to your local version of the Integration Pack installer program and double-click it.The installer opens.
- Click Next on the Welcome screen.
- Read and accept the End User License Agreement.Accept the agreement to continue.
- Specify where you want the integration pack files installed and click Next.
- Select the ADA Extension for APM installable component.
- Click Next.
- Specify the Enterprise Manager hostname and port to which this installable component will connect and click Next.
- Specify the hostname or IP address of all the ADA consoles to which this installable component will connect and click Next.
- Specify whether to configure the ADA Extension for APM as a Windows service and click Next.In a Windows OS environment, the ADA Extension for APM installable component installs the ADA-APM service.
- Review your settings and click Install.
CA Application Delivery Analysis Property Files
After you install the CA Application Delivery Analysis Extension for APM, the ADAExtensionForAPM folder contains the ADAConnector files. These files let you verify configuration settings and update default settings if necessary.
The following configuration settings are part of the CA Application Delivery Analysis Extension for APM installable component, but you can verify and update them using these properties:
- Enterprise Manager host namecom.wily.apm.adaconnector.em.host=<EM host name>
- Enterprise Manager port numbercom.wily.apm.adaconnector.em.port=<EM port>
- Host names or IP addressesThis information reflects the values of all the ADA Manager to which the CA Application Delivery Analysis Extension for APM installable component is connectedcom.wily.apm.adaconnector.adawssoap_address_source1=<addr> com.wily.apm.adaconnector.ada_hostName1=<host name>
- Name of the installer programcom.wily.apm.adaconnector.ada_processName1=<ADAExtensionforAPM>The ADAExtensionforAPM value represents the process name as seen on the Workstation.
The ADAConnector files make the following configuration settings available:
- Enhanced metricsThe queries for these infrastructure metrics are disabled by default. Enable the query if you want to make the following infrastructure metrics available on the Workstation:
- Data Transfer Time
- Network Round Trip Time
- Retransmission Delay
- Server Response Time
Sample property:com.wily.apm.adaconnector.ada_enhancedmetrics_enabled2=<true|false><enabled2>is an index of your ADA Manager. The first ADA Manager corresponds to<enabled1>, second Management console corresponds to<enabled2>, and so on. - CA Application Delivery Analysis web service queryThe wait period between the ADA data time bin and web service query. The default wait time is 5 minutes. The ADA Manager can connect to several collectors, such as Multi-Port Monitors and single port ADA collectors. To allow for aggregation of the collected data, ADA time bins are 5-minutes wide and end at 5-minutes boundaries, for example, 7:00, 7:05, and so on. ADA Manager updates its database every 5-minutes. The wait period value in this property shifts the query from exact 5-minutes boundaries by the specified time frame. For example, defining the wait period as 2-minutes shifts the ADA time bins to 7:02, 7:07, and so on.CA Technologies recommends that you donotchange the default value unless instructed byCA Support.Updating this property does not change the web service call frequency. This frequency is fixed at 5-minutes intervals.Sample property (units are in milliseconds):com.wily.apm.adaconnector.adawebservice.wait=120000
- SmartStor data feed intervalData feed interval from ADA to Enterprise Manager.The default interval is 15 seconds. CA Technologies recommends that you donotchange the default value unless instructed byCA Support.Sample property (units are in milliseconds):com.wily.apm.adaconnector.smartstorfeed.interval=15000
- SmartStor data feed wait timeThe wait period between the CA Application Delivery Analysis web service query and Enterprise Manager starting its data feed.The default wait time is 10 seconds. CA Technologies recommends that you donotchange the default value unless instructed byCA Support.Sample property (units are in milliseconds):com.wily.apm.adaconnector.smartstorfeed.wait=10000
Start the ADA-APM Service
After you install the ADA Extension for APM installable component, start the ADA-APM service.
Windows OS
Start the ADA-APM service in Windows Services.
This service does not start automatically. You start it manually after the installation.
Linux/UNIX OS
Start the ADA Extension for APM using the following command:
<INSTALL_HOME>\ADAExtensionForAPM$./ADAConnector
Synchronize Time
Synchronize the clocks between the following machines to a common time source:
- CA Application Delivery Analysis
- Enterprise Manager or MOM
Synchronizing the clocks helps to ensure the integrity of
DX APM
application data on the CA NetQoS Performance Center/CA Performance Center and infrastructure data on the APM WebView. If this task is not performed, time between the components can drift, leading to data inaccuracies or loss.CA Technologies recommends synchronizing your entire network to a Network Time Protocol time source or a time server. If this is not possible, then at a minimum, you must synchronize the machines discussed.
Verify the Connection
Look for the out-of-the-box dashboard and certain network metrics to confirm the
DX APM
to ADA connection.Follow these steps:
- Log on to either the APM WebView or Introscope Workstation.
- Look for the Network Status Information dashboard on the Console.
- Look for the following information for each client subnet and server on the Investigator, Metric Browser tab:
- Network health status
- Server health status
- Data Transfer Time
- Network Round Trip Time
- Retransmission Delay
- Server Response Time
- Data Transfer Time
- Network Round Trip Time
- Retransmission Delay
- Server Response Time
com.wily.apm.adaconnector.ada_enhancedmetrics_enabled1=<true|false>property in the ADA property file. See the How to Connectscenario for information on this property file.DX APMto Application Delivery Analysis
From the Network Status Information dashboard, you can navigate directly to NPC/CA Performance Center. In addition to this out-of-the-box dashboard, the infrastructure metrics are also available for you to create custom dashboards.
Note:
For more information about creating dashboards, see the DX APM
Workstation User Guide