Show TOC

Using Introscope Agent for Workload AnalysisLocate this document in the navigation structure

Wily Introscope is a third-party diagnostic tool that provides workload data, basic tracing functionality, and historic diagnostics data. To use Introscope with SAP Mobile Platform Server, install the Introscope Enterprise Manager, and install and configure Introscope Agent.

Note

In a clustered environment, you must install the Introscope Agent on each server node in the cluster. Repeat the Introscope Agent install and configure tasks on each server node. Introscope Enterprise Manager can be installed on any of the server nodes.

Installing Introscope Agent
  1. Navigate to the SAP Service Marketplace Software Download CenterInformation published on SAP site (login required).
  2. In the left pane, select Start of the navigation path Support Packages and Patches Next navigation step Browse our Download Catalog End of the navigation path, then select Start of the navigation path SAP Technology Components Next navigation step SAP Solution Manager Next navigation step SAP Solution Manager 7.1 Next navigation step Entry by Component Next navigation step Agents for Managed Systems End of the navigation path.
  3. Select the supported Introscope Agent and follow the screen prompts for download.
Note For information about the supported version of Introscope Agent, see SAP Product Availability Matrix (PAM) https://apps.support.sap.com/sap/support/pamInformation published on SAP site. Search for SAP Mobile Platform 3.0 (search box in the upper-right corner), and select either SAP Mobile Platform 3.0 or SAP Mobile Platform SDK 3.0. In the upper right corner of the SAP Mobile Platform PAM screen under the Essentials heading, click Open in New Window to open the Support Matrices for SAP Mobile Platform 3.0 documentation.
Installing Introscope Enterprise Manager
  1. Download Introscope Enterprise Manager from the SAP Service Marketplace Software Download Center. The Introscope Enterprise Manager is located in the SAP Solution Manager Software Downloads section:
    1. Navigate to the SAP Service Marketplace Software Download CenterInformation published on SAP site (login required).
    2. In the left pane, select Start of the navigation path Support Packages and Patches Next navigation step Browse our Download Catalog End of the navigation path, then select Start of the navigation path SAP Technology Components Next navigation step SAP Solution Manager Next navigation step SAP Solution Manager 7.1 Next navigation step Entry by Component Next navigation step Wily Introscope End of the navigation path.
    3. Select the supported Introscope Enterprise Manager and follow the screen prompts for download.
  2. Install Introscope Enterprise Manager.
Note For information about the supported version of Introscope Enterprise Manager, see SAP Product Availability Matrix (PAM) https://apps.support.sap.com/sap/support/pamInformation published on SAP site. Search for SAP Mobile Platform 3.0 (search box in the upper-right corner), and select either SAP Mobile Platform 3.0 or SAP Mobile Platform SDK 3.0. In the upper right corner of the SAP Mobile Platform PAM screen under the Essentials heading, click Open in New Window to open the Support Matrices for SAP Mobile Platform 3.0 documentation.
Configuring Introscope Agent for SAP Mobile Platform Server
To analyze performance metrics using the Introscope Enterprise Manager dashboard user interface, configure the supported Introscope Agent on SAP Mobile Platform Server.
Note Do not configure or enable the agent unless the supported Introscope Enterprise Manager version is already installed in the production environment.
  1. Download the file attachments in SAP Note 1911963Information published on SAP site to <SMP_HOME>\Introscope_Agent\wily\core\config\.
  2. Open the <SMP_HOME>\server\props.ini file, and add the following lines immediately below the lines that begin with -Dcom:
    -javaagent:C:/SAP/MobilePlatform3/Introscope_Agent/wily/Agent.jar
    -Dcom.wily.introscope.agentProfile=C:/SAP/MobilePlatform3/Introscope_Agent/wily/core/config/IntroscopeAgent_SMP.profile
    -Dcom.wily.introscope.agent.agentName=SAPMobilePlatform
    -XX:-UseSplitVerifier
    
  3. Restart SAP Mobile Platform Server for the change to take effect.
Configuring the IntroscopeAgent_SMP.profile File

Edit the IntroscopeAgent_SMP.profile file to specify the server name and port number where Enterprise Manager was installed.

  1. Open the <SMP_HOME>\Introscope_Agent\wily\core\config\IntroscopeAgent_SMP.profile file as follows:
    1. Modify introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=localhost to correspond with the installed Enterprise Manager host, instead of localhost.

    2. Modify introscope.agent.enterprisemanager.transport.tcp.port.DEFAULT=6001 to correspond with the installed Enterprise Manager host's port, which is 6001 by default.

  2. Restart SAP Mobile Platform Server.
SAP Mobile Platform Metrics Collected by Introscope

You can view the metrics collected by SAP Mobile Platform Server in Introscope. Be aware that some metrics are contained and measured as part of other metrics, as identified below, and could be measured twice.

Table 1: Introscope Metrics for SAP Mobile Platform
Metric Description
SMP|Dispatcher Authentication Time to authenticate client.
SMP|ODataProxy|Back end Time to send and receive an HTTP request of an OData source, such as the SAP NetWeaver Gateway.
SMP|Application Connections|ApplicationODataProducer|createEntity Create a new entity representing a client registration.
SMP|Application Connections|ApplicationODataProducer|getEntity Retrieve an entity representing a client registration.
SMP|Admin|Process Process a request from Management Cockpit.
Introscope Transaction Trace Sessions with SAP Mobile Platform

Introscope provides the ability to trace requests from clients. Introscope refers to this feature as a Transaction Trace Session. You can trace requests by either User ID or Request Header.

To filter by User ID:
  1. In the New Transaction Trace Session dialog, select User ID from the list.

  2. Select equals, and enter the User ID. The User ID is the value provided by the client for authentication, and appears in Management Cockpit, under Application Registrations as the User Name.

Alternately, if the client specifies an HTTP header value of either X-SUP-APPCID or X-SMP-APPCID, you can filter transactions by the header value. The HTTP Cookie value with the same name does not work for filtering transactions.

To filter by header value::
  1. In the New Transaction Trace Session dialog, select Request Header from the list.

  2. Enter either X-SUP-APPCID or X-SMP-APPCID, depending on which header the client sends.

  3. Select equals, and enter the APPCID sent by the client. The APPCID appears in Management Cockpit, under Application Registrations as the Registration ID.