CA APM and CA Spectrum

 Starting from CA Spectrum 10.3 release, the 
Spectrum SNMP Trap
 plugin is deprecated and will not be shipped with CA Spectrum. However, you can use the 
SNMP Alert Action
 plugin of CA APM for the trap generation between CA Spectrum and CA APM.
Spectrum SNMP Trap
 plugin of CA 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
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 CA 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.
CA 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,
    CA 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
CA Spectrum
. An alarm is generated on a WilyAgent model. If the alert is cleared,
CA Spectrum
is notified and clears the associated alarm.
CA 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,
    CA 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,
    CA 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
CA Spectrum
integration, and identifies the direction of data transfers.
 APM Architecture.png
Integration 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
      CA Spectrum
      CA Spectrum
      uses only the agent information.
    • A bi-directional subscription web service, introscope-wssdk-consumer, uses the Apache Muse framework, which is deployed inside
      / 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
    CA 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
    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.