Administrator

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, install the Introscope Enterprise Manager, and install and configure Introscope Agent.

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.

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.

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