Integration with CA APM

casp1032
 
 
Starting from the 10.3 release, the 
Spectrum SNMP Trap
 plugin is deprecated and will not be shipped with 
DX NetOps Spectrum
. However, you can use the 
SNMP Alert Action
 plugin of CA APM for the trap generation between 
DX NetOps Spectrum
 and CA APM.
The 
Spectrum SNMP Trap
 plugin of 
DX NetOps Spectrum
 and 
SNMP Alert Action
 feature of CA APM both are used for the same purpose (for trap generation). Since, the 
SNMP Alert Action
 feature of CA APM has more enhanced functionality, we recommend you to use the 
SNMP Alert Action
 in CA APM for the trap generation.
To configure the SNMP Alert Action plugin, see the Create and Configure Notification Actions section. To migrate from 
Spectrum SNMP Trap
 to 
SNMP Alert action
, see Migrate from Spectrum SNMP Trap to SNMP Alert Action of CA APM.
Integration Prerequisites
Beginning with version 9.1 of CA Application Performance Management (CA APM), the name "Wily" was dropped from the CA Wily Introscope® product. This section retains the name where it helps to clarify compatibility with previous versions of CA APM.
For 
DX NetOps Spectrum
 and CA APM integration information, see the Integration Compatibility page.
How the Integration Works
CA Application Performance Management (CA APM) consists of an Enterprise Manager and one or more CA Introscope agents. Introscope agents are installed on servers running Java virtual machines (JVMs). The agents deliver information about numerous metrics, such as servlet response time and report metrics, to the Enterprise Manager.
Enterprise Manager uses a Management Module to organize and report on the metric data provided by an agent. By configuring thresholds on reported metrics, Enterprise Manager creates an alert when a threshold is violated and clears the alert when the threshold is no longer violated. Introscope agents are polled every 60 seconds to determine whether a threshold has been violated or whether a violated threshold has been cleared. An alert is created when a threshold event occurs.
 
DX NetOps Spectrum
 models the CA Introscope infrastructure using two model types, the IntroscopeAdmin model and the WilyAgent model.
  • The IntroscopeAdmin model represents one Enterprise Manager.
  • The WilyAgent model represents an application container (JVM or CLR). When you initiate a Discovery, or when a Discovery is initiated when you restart Tomcat, 
    DX NetOps Spectrum
     requests a list of application containers from the Enterprise Manager and models them as WilyAgent models.
When CA Introscope generates an alert, data about the metric and its threshold is forwarded to 
DX NetOps Spectrum
. An alarm is generated on a WilyAgent model. If the alert is cleared, 
DX NetOps Spectrum
 is notified and clears the associated alarm.
The 
DX NetOps Spectrum
 integration with CA APM also actively monitors the inventory of application containers on an Enterprise Manager.
  • When an Enterprise Manager starts to monitor a new application container, 
    DX NetOps Spectrum
     is notified and automatically creates a WilyAgent model to represent the application container.
  • When an Enterprise Manager no longer monitors a discovered application container, 
    DX NetOps Spectrum
     generates an alarm on the corresponding WilyAgent model.
If you move an Introscope agent from one Enterprise Manager to another, a new IntroscopeAgent model is created and associated with the IntroscopeAdmin model. That model represents the Enterprise Manager to which the agent was moved. This activity results in two identical IntroscopeAgent models associated with two distinct IntroscopeAdmin models. Destroy the original IntroscopeAgent model so that the new IntroscopeAgent model receives all subsequent events.
Integration Architecture
The following diagram depicts the architecture of the CA APM and 
DX NetOps Spectrum
 integration, and identifies the direction of data transfers.
  APM Architecture.png  
Integration Considerations
Review the following considerations: 
  • The integration combines web services with trap notifications:
    • A traditional axis 1.4 polling web service that provides inventory information, such as the Management Module, the agent, alert definitions, alerts, and Management Module/Agent pairs that help determine the 
      DX NetOps Spectrum
       model. 
      DX NetOps Spectrum
       uses only the agent information.
    • A bi-directional subscription web service, introscope-wssdk-consumer, uses the Apache Muse framework, which is deployed inside 
      $SPECROOT
      / tomcat/webapps. The introscope-wssdk-consumer web service listens for and processes asynchronous updates from CA Introscope.
  • Trap notifications require the installation of a trap generation plugin on the CA Introscope Enterprise Manager.
  • All communication between 
    DX NetOps Spectrum
     and CA Introscope passes through the Tomcat web server for agent inventory.
  • The integration can be enabled on only one server.
  • In a distributed 
    SpectroSERVER
     environment, designate a OneClick server as the integration server.
Maintenance Mode
You can put WilyAgent models into maintenance mode. However, the status of a WilyAgent model is dependent on event updates that the Enterprise Manager sends through SNMP traps. Therefore, before putting WilyAgent models into maintenance mode, consider the following:
  • If the WilyAgent model is in an alarm state, and the Enterprise Manager posts an alarm clear update during maintenance mode, the model remains in an alarm state when it comes out of maintenance.
  • If the WilyAgent model is in a normal state, and its counterpart on the Enterprise Manager enters an alarm state during maintenance mode, the model remains in a normal state when it comes out of maintenance.