Page Comparison

Setting up inspectIT

Download the inspectIT Server (CMR), inspectIT Agent and the inspectIT Rich Client from the following Release Site on GitHub: CoScale-Integration

Select the artifacts that fit to your environment (Linux/Windows/MacOS, x86/X64).

inspectIT Server

1. Download the inspectIT server aka. CMR (Central Measurement Repository) with integrated CoScale plugin from here:.
2. Extract the archive and execute the startup.sh (on Windows: startup.bat) script to start the server. 

...

1. Download the inspectIT Rich Client with the CoScale extension from here: .
2. Extract the archive and execute the inspectIT file (on Windows: inspectIT.exe) to start the rich client.
3. Connect the rich client to the CMR:
   1. Open the Repository Manager View
   2. If your CMR is running on the localhost, you already should see that the CMR is connected (green ball / checkmark):
      
      
      
   3. Otherwise configure a new connection to your CMR by clicking on .
   4. In the opened wizard enter the Name and IP-Address and click on Finish.
4. Define an instrumentation Environment (this step is important for the agent to be connected!)
   1. Switch to the Configuration perspective and open the Instrumentation Manager
      
      
      
   2. Create an instrumentation environment for your application. Give it some name.
       
       
   3. Open the agent mapping view:
       
      
      
   4. Create a new mapping by clicking on the green plus button at the right.
   5. In the wizard enter the name and IP address of your agent and select the previously created environment.
   6. Note: These steps provide only a basic instrumentation. How to create an advanced, meaningful instrumentation (that is application specific) is described on a separate page: Configuration basics

...

1. Download the inspectIT Agent from here:.
2. To install the inspectIT agent follow the instructions on the corresponding section on this page: Manual JavaAgent installation.
3. Once the application started successfully with the agent, the connected agent should appear under the CMR node in the Repository Manager View in the rich client:
   

...

Configuring CoScale Extension

To configure the CoScale extension follow these steps:

1. Select your CMR in the Image AddedRepository Manager View and open the CMR settings (Image Added "Configure Repository"):
   Image Added
   
   
2. In the configuration dialog enabled "Show advanced properties" (at the bottom) and navigate to Data Publishing Extensions → CoScale
   Image Added
   
   

3. Activate the CoScale plugin, enter the configuration properties and click on the OK button.

   Property Name	Description
   Activate	Enable / disable the CoScale Plugin.
   Access Token	The access token for the CoScale API.
   Application ID	The CoScale ID of the application of interest.
   Write Timings	If activated, the inspectIT CoScale plugin writes e-2-e latencies and calculated thresholds as metric data to CoScale.
   Base URL	The base URL to the CoScale server.
   Number of Invocations to Send	The number of slowest invocation sequences (per business transaction type) within an anomaly to be sent to CoScale as "forensic" data.
   Aggregation Time Interval (min)	The time interval in minutes to take for aggregation of response times and anomaly detection.
   Minimal Anomaly Duration	The minimum duration (in the time unit defined above) of anomal behaviour to be detected as an anomaly.
   Smoothing Factor	Smoothing factor for the Exponentially Weighted Moving Average used for anomaly detection
   Trend Smoothing Factor	The factor for the Trend component of the anomaly detection
   Standard Deviation Factor	The anomaly detection algorithm learns baselines on the latencies of business transactions. On top of this baseline, the algorithm adds a multiple of the standard deviation of the latency values to calculate a threshold curve that detemines when an anomaly should be detected. This property defines the factor to be multiplied with the standard deviation before adding the result to the baseline value.

4. If the configuration was correct then inspectIT should have retrieved the Business Context configuration from CoScale. To check this navigate to the Image AddedConfiguration Perspective → Image AddedBusiness Context Manager. There, a new application with the same name as configured in CoScale should have been appeared. Open this application and check whether the business transactions have been successfully retrieved.

Now inspectIT should be fully configured to detect anomalies on the target application and in case of an anomaly sends invocation sequence storages to CoScale.

Analyzing inspectIT Storages

InspectIT Storages that have been sent as forensic data to CoScale can be downloaded in the dashboard views of CoScale:

Image Added

Once an inspectIT storage has been downloaded it can be imported with the inspectIT Rich Client:

1. Open the Image AddedStorage Manager View
2. Select Local Storage View:
   Image Added
   
   
3. Import Storage Image Added
4. Select "Import to Local machine"
   Image Added 
    
5. Click Next and then Finish
6. Double-click on the imported storage to open the Image AddedData Explorer View
7. Navigate to Image AddedInvocation Sequences → Image AddedShow All to view the recorded invocation sequences for the detected anomaly:
   Image Added