Configure the CA Spectrum LAM

CA Spectrum provides deep application monitoring and performance lifecycle management. The CA Spectrum LAM connects to CA Spectrum, fetches the incidents and forwards them to Moogsoft AIOps.

The CA Spectrum API does not supply events with status 'clear' for collection by Moogsoft AIOps.

See CA Spectrum for UI configuration instructions.

The workflow of gathering events from CA Spectrum and publishing it to Moogsoft AIOps is as follows:

Configuration

Events received from CA Spectrum are processed according to the configuration in the ca_spectrum_lam.conffile and then they are published to the Moogsoft AIOps.

The configuration file contains a JSON object. At the first layer of the object, LAM has a parameter called config, and the object that follows config has all the necessary information to control the LAM.

Monitor

The CA Spectrum LAM takes the incidents from the CA Spectrum Servers. To establish a connection with the CA Spectrum, you can configure the parameters here:

General

Secure Sockets Layer

To set up SSL for CA Spectrum, refer to the CA Spectrum documentation.

Configure the SSL properties for each target if you want to encrypt communications between CA Spectrum and Moogsoft AIOps:

Filter

Example

monitor:
{
    name: "CA Spectrum Lam Monitor",
    class: "CCASpectrumMonitor",
    request_interval: 60,
    max_retries: -1,
    retry_interval: 60,
    retry_recovery:
    {
        recovery_interval: 20,
        max_lookback: -1
    },
    targets:
           {
           target1:
                  {
                      url: "http://localhost:8080", 
                      user_name: "user name", 
                      password: "password",
                      #encrypted_password: "ieytOFRUdLpZx53nijEw0rOh07VEr8w9lBxdCc7229o=",
                      request_interval: 60,
                      max_retries: -1,
                      retry_interval: 60,
                      retry_recovery:
                                    {
                                        recovery_interval: 20,
                                        max_lookback: -1
                                    },            
                      #proxy:
                      #{
                          #host: "localhost",
                          #port: 8181,
                          #user: "user",
                          #password: "pass",
                          #encrypted_password: "ieytOFRUdLpZx53nijEw0rOh07VEr8w9l="
                          #},
                          disable_certificate_validation  : false,
                          path_to_ssl_files: "config",
                          server_cert_filename: "server.crt",
                          #client_key_filename: "client.key",
                          #client_cert_filename: "client.crt",                   
                          limit: 1000,
                          timeout: 120,
                          filter:
                          {
                              acknowledged: false
                          }              
                      },
           target2:
                  {
                      url: "http://localhost:8080",
                      user_name: "user name",
                      password: "password",
                      request_interval: 60,
                      max_retries: -1,
                      retry_interval: 60,
                      disable_certificate_validation: false,
                      #path_to_ssl_files: "config",
                      #server_cert_filename: "server.crt",                     
                      limit: 1000,
                      timeout: 120,
                      filter:
                            {
                                acknowledged: "false"                        
                            }
                  }
           }
},
agent:
{
    name: "CA Spectrum",
    capture_log: "$MOOGSOFT_HOME/log/data-capture/ca_spectrum_lam.log"
},
log_config:
{
    configuration_file: "$MOOGSOFT_HOME/config/logging/caspectrum.log.json"
}

Agent and Process Log

Agent and Process Log allow you to define the following properties:

Mapping

You can directly map the alert/event fields of CA Spectrum with Moogsoft AIOps fields displayed in Moogsoft AIOps. The mapping example is as follows:

 mapping :
        {
            catchAll: "overflow",
                        rules:
           [
                { name: "signature", rule:      "$serverName :: $alarmId" },
                { name: "source_id", rule:      "$modelId" },
                { name: "external_id", rule:    "$significantModelId" },
                { name: "manager", rule:        "CA Spectrum" },
                { name: "source", rule:         "$serverName" },
                { name: "class", rule:          "$modelClass" },
                { name: "agent", rule:          "$LamInstanceName" },
                { name: "agent_location", rule: "$networkAddress" },
                { name: "type", rule:           "$modelTypeName" },
                { name: "severity", rule:       "$severity", conversion:"sevConverter" },
                { name: "description", rule:    "$alarmTitle :: $originatingEvent" },
                { name: "agent_time", rule:     "$creationDate", conversion:"stringToInt"}
            ]
        },
        filter:
        {
            presend:"CASpectrumLam.js"
        }

The above example specifies the mapping of the CA Spectrum alarm fields with the Moogsoft AIOps fields. Data not mapped to fields goes into "Custom Info".

Constants and Conversions

Constants and Conversions allows you to convert formats of the received data.

sevConverter:
{
    lookup : "severity",
    input  : "STRING",
    output : "INTEGER"
},

stringToInt:
{
    input  : "STRING",
    output : "INTEGER"
},

timeConverter:
{
    timeFormat : "yyyy-MM-dd'T'HH:mm:ss.SSS",
    input      : "STRING",
    output     : "INTEGER"
}

Example

Example Constants and Conversions

constants:
        {
            severity:

                        {
                "0"        : 0,
                "1"        : 1,
                "2"        : 2,
                "3"        : 3,
                "4"        : 4,
                "5"        : 5
            }
        },
        conversions:
        {
            sevConverter:
            {
                lookup: "severity",
                input:  "STRING",
                output: "INTEGER"
            },

            stringToInt:
            {
                input:      "STRING",
                output:     "INTEGER"
            },
         
            timeConverter:
            {
                timeFormat: "yyyy-MM-dd'T'HH:mm:ss.SSS",
                input:      "STRING",
                output:     "INTEGER"
            }
        },

Service Operation Reference

Start the LAM Service:

service caspectrumlamd start

Stop the LAM Service:

service caspectrumlamd stop

Check the LAM Service status:

service caspectrumlamd status

If the integration fails to connect to one or more CA Spectrum sources, creates an alert and writes the details to the process log. Refer to the logging details for LAMs and integrations for more information.

Command Line Reference

You can see the available optional attributes of the ca_spectrum_lam by running the following command:

ca_spectrum_lam --help

The ca_spectrum_lam is a command line executable, and has the following optional attributes: