Using Introscope Agent for Workload Analysis

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, you need to install the Introscope Enterprise Manager, install the SAP Mobile Platform Introscope Agent, and configure the agent.

Installing Introscope Enterprise Manager

Install 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 screen prompts for download.
Install Introscope Enterprise Manager.

Note: For information about the supported of the Introscope Enterprise Manager and Introscope Agent, see SAP Product Availability Matrix (PAM) http://service.sap.com/pam. Click the Mobile link at the top of the page. Scroll to find the appropriate product and version in the product list. 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 and Configuring the SAP Mobile Platform Introscope Agent

Install and configure the supported Introscope Agent on SAP Mobile Platform Server to analyze performance metrics using the Introscope Enterprise Manager dashboard user interface.

Note: Do not configure or enable the agent unless the supported Introscope Enterprise Manager version is already installed in the production environment.

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 > WILY INTRO AGT 9 MIN J5 > OS independent.
Download the Introscope Agent file to SMP_HOME\Introscope_Agent.
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\\Introscop_Agent\\wily\\core\\config\\IntroscopeAgent_SMP.profile
-Dcom.wily.introscope.agent.agentName=SAP Mobile Platform
-XX:-UseSplitVerifier

Reconfigure the SAP Mobile Platform Server Windows service 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 the 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 inadvertently be measured twice.

Introscope Metrics for SAP Mobile Platform
Metric	Description
SMP\|Dispatcher Authentication	Time to authenticate client.
SMP\|ODataProxy\|Backend	Time to send and receive an HTTP request of an OData source, such as the SAP NetWeaver Gateway.
SMP\|Core Services\|Registration\|Create	Create a new entity representing a client registration.
SMP\|Core Services\|Registration\|Retrieve	Retrieve an entity representing a client registration.
SMP\|Admin\|Process	Process a request from the Management Cockpit.

Introscope Transaction Trace Sessions with SMP

Introscope includes the ability to trace requests from clients. Introscope refers to this feature as a Transaction Trace Session. The requests traced may be filtered by User ID or by Request Header.

To filter by User ID in the dialog named “New Transaction Trace Session”, select “User ID” in the dropdown list. Then, select “equals”. Finally specify the User ID. The User ID is the same as the User Name shown in the SAP Mobile Platform Administration display of Application Registrations. The User ID is the same value provided by the client for authentication.

Alternately, if the client specifies an Http header value of either X-SUP-APPCID or X-SMP-APPCID, then transactions may be filtered by a header value. The Http Cookie value with the same name will not work for filtering transactions. In the dialog named “New Transaction Trace Session”, select “Request Header” in the dropdown list. Input either X-SUP-APPCID or X-SMP-APPCID, depending upon which header the client is sending. Then, select “equals”. Finally specify the value sent by the client. The value for the APPCID is shown in the Management Cockpit display of Application Registrations and is labeled Registration ID.