Using Introscope Agent for Workload Analysis

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

Navigate to the SAP Service Marketplace Software Download Center (login required).
In the left pane, select Support Packages and Patches Browse our Download Catalog , then select SAP Technology Components SAP Solution Manager SAP Solution Manager 7.1 Entry by Component Agents for Managed Systems .
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/pam Information 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

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 Center (login required).
2. In the left pane, select Support Packages and Patches Browse our Download Catalog , then select SAP Technology Components SAP Solution Manager SAP Solution Manager 7.1 Entry by Component Wily Introscope .
3. Select the supported Introscope Enterprise Manager and follow the screen prompts for download.
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/pam Information 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.

Download the file attachments in SAP Note 1911963 to <SMP_HOME>\Introscope_Agent\wily\core\config\.

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

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.

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.
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:

In the New Transaction Trace Session dialog, select User ID from the list.
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::

In the New Transaction Trace Session dialog, select Request Header from the list.
Enter either X-SUP-APPCID or X-SMP-APPCID, depending on which header the client sends.
Select equals, and enter the APPCID sent by the client. The APPCID appears in Management Cockpit, under Application Registrations as the Registration ID.