CA Spectrum

This integration uses a workflow within xMatters to become the voice and interface of an automation engine. When CA Spectrum detects something that requires attention, xMatters places phone calls, send emails, or notifies your mobile app.

The instructions cover the following topics:

How it works

The integration adds functionality to the CA Spectrum Alarm Notifier scripts, which communicate via the xMatters Integration Agent. xMatters sends response information back via the CA Spectrum Web Services API, allowing users to own, acknowledge, and escalate alerts, and clear events remotely from their device.

When CA Spectrum detects an event, it invokes an Alarm Notifier Script, which uses a command-line interface call to send the details to xMatters via the Integration Agent. xMatters notifies the correct recipients, and then uses a REST-based call to the CA Spectrum web services API to update the original event with response information.

You may need to customize some aspects of this integration to suit your specific requirements. For example, automatic status updates are turned on in the default configuration, which can be a significant resource constraint on high-volume systems.

Integration version — features and updates

This version of the integration (3.0.1) is compatible with CA Spectrum 10.2.0 and above, and is designed specifically for xMatters. This version of the integration included the following updates and enhancements:

The integration now targets the inbound integrations included in the workflow rather than the form itself. This provides access to all of the enhancement and options available in the Integration Builder, including the Activity Stream, transformation scripts, and authentication options.

Before you begin

Before you get started configuring the integration, there are a couple of things you can do ahead of time to make it easier: download the workflow and create a user in CA Spectrum that can make API calls. This integration also requires the Integration Agent.

Configure xMatters

The first step in configuring this integration is to set up the components on the xMatters side:

  • Set up an integration user that CA Spectrum will use to authenticate with xMatters.
  • Create a web service user for the Integration Agent.
  • Import the workflow.
  • Gather the URLs and IDs you need to complete the configuration in CA Spectrum and the Integration Agent.

Configure the xMatters Integration Agent

Now that you've configured xMatters, it's time to configure the Integration Agent. This involves installing and configuring the integration files, setting up the password files, and enabling deduplication to suppress duplicate alerts.

The installation instructions below assume you already have a working xMatters Integration Agent. If this is a new installation and you have not yet deployed the Integration Agent, download, deploy, and configure the Integration Agent before continuing.

The following instructions use <IAHOME> to refer to the installation folder of the Integration Agent on your system. Change this to the path on your system as needed.

Configure CA Spectrum

To configure CA Spectrum to integrate with xMatters, you need to modify the CA Spectrum Alarm Notifier Scripts.

The following steps use <CAS_HOME> to refer to the base installation directory of your CA Spectrum instance.

And that's it! Your integration should be ready to go.

How to use the integration

When the integration is configured, CA Spectrum automatically sends information about any alarms it detects to xMatters via the Integration Agent. Try out triggering and responding to a notification to check that everything is working as you expect.

Extend and optimize your integration

You can use the following tips to customize your integration to better suit your deployment.

Download resources

Get the workflow