Using CA Continuous Application Insight › CA Continuous Application Insight Agent Light › Agent Light for webMethods HTTP

Agent Light for webMethods HTTP

The Agent Light for webMethods HTTP is an agent that communicates with CA Continuous Application Insight using a REST API. The purpose of the light agent is to take the input from a webMethods HTTP request/response data file and send the data to CAI through the REST API call.

The agent light can receive the webMethods HTTP transactions from the following sources:

• HTTP transaction data file

  The light agent uses the -f parameter to take a data file as an input. The data in this file must be in the standard HTTP request/response format. See the Input Transaction Data Format for HTTP topic for more information about the standard data format.

  The transaction parameters from the data file are:

  -f, -file

  Defines the transaction data file to be imported into CAI.

  -t, -type

  Indicates the data protocol type.
  Default: http

  Create a path from data file using the following example code:

  Java -jar lisaagentlight.jar -url http://<LisaServer>:1505 -f webmethods.log -t http
  

• webMethods log file using a Splunk query

  When the webMethods integration server is set to trace, the web service call details for the HTTP request/response are logged to the log file. Splunk indexes the log file and produces the HTTP transaction data. The agent light queries Splunk to retrieve the webMethods integration server HTTP transactions and creates the CAI paths for them.

  The transaction parameters from Splunk are:

  -splunk

  Indicates transactions acquired from Splunk.

  -h, -hostname

  Defines the Splunk server hostname or IP address.

  -port

  Defines the Splunk port number.

  -u, -username

  Defines the Splunk server user name.

  -p, -password

  Defines the Splunk server password.

  -s, -search

  (Optional) Defines the Splunk transaction search statement.

  -t, -type

  Defines the data protocol type. HTTP, JMS, and MQ are supported.

  Default: HTTP

  -m, -maxtrans

  Defines the maximum transactions to be imported.

  Default: 500

  Create a path from Splunk using the following example code:

  Java -jar lisaagentlight.jar -url http://<LisaServer>:1505 -splunk -hostname 10.130.151.105 -port 8089 -username admin -password admin
  

When you query the Splunk server for webMethods HTTP transactions, a Splunk query statement must be provided. The agent has an integrated default query statement. If you want a different query, pass in the new query statement using the -search parameter.

The following example displays a default query statement:

"search index=main ((CASE(GET) OR CASE(POST) OR CASE(PUT) OR CASE(DELETE)) /*) OR ((Accept OR User-Agent OR Accept-Encoding OR \"-- Host\" OR Authorization OR Cookie OR Accept-Language OR \"-- Connection\" OR lisaFrameRoot OR lisaFrameRemoteIP OR lisaFrameID OR Authorization OR Set-Cookie OR SOAPAction OR Content-Type OR Content-Length): *) OR (\" SOAP Request:\") OR (\" SOAP Response:\") OR (HTTP/1.*) | transaction startsWith=(CASE(GET) OR CASE(POST) OR CASE(PUT) OR CASE(DELETE)) endsWith=(\"--> Content-Length: \")  | where !searchmatch(\"-- User-Agent: webMethods\")"

Note: When the Agent Light for webMethods HTTP is executed from a remote system, the DevTest Server REST URL must be specified or the agent assumes the DevTest Server is local. The URL format is http://<lisa-server>:1505.

The agent light has the following arguments:

-url

Defines the CAI REST base URL.

Default: http://localhost:1505

-wsuser

(Optional) Defines the CAI REST username.

-wspassword

(Optional) Defines the CAI REST password.