Using Data Import API

Importing Data from Other Tools into Applicare

1. Deploy the Applicare Standalone Collector (instructions available in the Applicare installation guide) with a default port of 9880 to collect data from external application.

2. Modify the attached ImporterImpl.java file and map the appropriate data from the external app database to the Applicare API's input. Compilation of this code will require servlet-api.jar, applicare-aspects.jar and data.importer.jar in the classpath. You can use an Eclipse Java project and create a .jar file from there.

3. Build a .jar file and deploy that to the Standalone Collector by copying the .jar to the /Applicare/server/lib directory. Drop the default importer file (data.importer.impl.empty.jar).

4. Start the Standalone Collector and data import will begin.

5. Add this Standalone Collector to the Applicare console

6. Enable Business Transactions & User Experience monitoring by deploying those aspects in Configuration -> Configure Dynamic Instrumentation.

7. Create KBTs.

Creating an HTTP call

ImportUtils.addHttpInvocation("/request.from.outside" , duration);

where "/request.from.outside" is the URI to be shown on the profiler

Duration is the time counted for the HTTP call.

Creating a Business Transaction

ImportUtils.addBtmInvocation("/request.from.outside", duration , time , "localhost","server1");

where:

/request.from.outside is the URI

duration is the difference between start time and end time

time is when the transaction has been executed

localhost is the ip address.

server1 is the server name.

Creating a User Experience Record

ImportUtils.addUEMInvocation( "www.mywebsite.com",  "server1", false,10, 11, "CHROME", "0.5", "OS2", 200, starttime,endtime, 20, 40, 80, "193.32.12.67");

where:

www.mywebsite.com is the URI of the call

server1 is the server name

false is it a slow transaction?

10 is average time

11 is backend time

CHROME is browser type

0.5 is browser version

OS2 is operating system

200 is HTTP return code

20 is server response time to first byte

40 is page rendering time

80 is total page load time

start time is when the page load started

end time is when the page load ended

193.32.12.67 is the browser/client IP address

addUEMInvocation(

String url,  String server,

boolean isSlowTransaction, double avgTime, int backEndTime,

String browserName, String browserVersion, String os,

int httpReturnCode, long beginTime, long EndTime, int respTime,

int pageTime, int totalTime , String ip) 

Available with Applicare 7.2.4 Beta onwards

ImporterImpl.java